Salsa Vida MCPサービス


AIアシスタントやアプリケーションから、Salsa Vidaで公開されているサルサ・バチャータのイベント情報や各地のガイドを利用できます。Model Context Protocol(MCP)は、対応クライアントがこうした情報を検索し、出典へのリンクを提示するための標準的な仕組みです。

接続方法

エンドポイント: https://mcp.salsavida.com/mcp
トランスポート: Streamable HTTP
認証: 不要。公開情報の読み取り専用です。

対応クライアントに、このURLをリモートMCPサーバーとして追加してください。許可を求められたら、4つの読み取り専用ツールの利用を許可します。接続先のサーバーと利用するタイミングは、クライアント側が決めます。MCPエンドポイントを公開しても、Salsa Vidaがすべてのチャットボットに自動的に接続されるわけではありません。

Codex CLIの場合:

codex mcp add salsa-vida --url https://mcp.salsavida.com/mcp

Claude Codeの場合:

claude mcp add --transport http salsa-vida https://mcp.salsavida.com/mcp

カスタムコネクタに対応したアプリケーションでは、コネクタ設定を開き、上記のエンドポイントを追加してください。利用可否や必要なアカウントはクライアントによって異なります。ディレクトリへの掲載や審査は、直接接続とは別の手続きです。

利用できるツール

  • search_locations:都市・地域・国を検索し、変わらない地域IDや地理的な情報を取得します。
  • search_events:場所、日付、ダンス、イベントの種類、サルサのスタイル、言語でイベントを検索します。
  • get_event:指定した期間内のイベントの基本情報と開催予定日を取得します。
  • get_guide:既存の地域ガイドの概要と、Salsa Vidaの関連リンクを取得します。

最新の入力・出力スキーマは、ツールの検出機能で確認してください。複数の場所を指す可能性がある地名は、検索前に目的地を特定します。同名の目的地が複数ある場合は、地域IDを優先して使ってください。

質問の例

  • 今後2週間にサンフランシスコで開催されるサルサのソーシャルには、どのようなものが掲載されていますか?
  • 東京のバチャータレッスンを探して、詳細へのリンクを教えてください。
  • 旅行期間中にスペインで開催予定のフェスティバルはありますか?
  • フランスのパリについて、Salsa Vidaのガイドを見せてください。
  • この定期開催イベントはいつ開催予定で、どの情報がまだ不明ですか?

対象範囲と情報の読み取り方

このサービスは、Salsa Vidaで公開されている世界各地の地域情報、条件を満たす今後のイベント情報、既存の都市・地域・国のガイドを対象としています。イベントの日付は、順次更新される今後1年間の範囲で検索できます。期間を指定しない場合は、今後14日間を検索します。インデックスに収録されている正確な日付範囲は、応答に含まれます。インストラクターのプロフィール、記事、ダンスペディア(Dancepedia)、非公開の調査情報は今回の公開範囲に含まれません。

標準の検索期間は、UTCでの当日から始まります。「今日」や「今夜」を検索するときは、利用者の現地の日付を明示的に指定してください。UTCでは日付が変わっていても現地ではまだ前日である地域に対応するため、インデックスには前日分も保持しています。出典にタイムゾーンがない場合、日付だけからタイムゾーンを推定することはありません。

応答には、取得可能なタイトル、簡潔な説明、会場と住所、日付、判明している時刻、分類、掲載されている料金、Salsa Vidaへのリンクが含まれます。不明な情報は不明のまま返します。公開済みの翻訳があればその言語を使い、なければ英語で代替したことを明示します。翻訳されたイベントでも、元のイベントと開催回のIDは共通です。

サルサのスタイルによる絞り込みには、記録されている分類だけを使います。まだスタイルが分類されていないイベントも多いため、スタイルで絞り込んだ検索が0件でも、その地域でそのスタイルが踊られていないことを意味するわけではありません。

定期開催の日付は、記録された繰り返しルールに基づく開催予定です。主催者が各回の開催を確認したという意味ではありません。複数日にわたるフェスティバルは、1回の開催としてまとめます。同期のタイムスタンプは、インデックスを確認または更新した時点を示し、主催者がイベントを確認した時点を示すものではありません。旅行の計画を立てる前に、Salsa Vidaのイベントページや主催者の案内を確認してください。

情報の鮮度とサービスの稼働状況

このサービスは、約5分ごとに元の情報の変更を確認します。応答には、確認時点のタイムスタンプを含めます。確認の遅れは15分後に表示され、1時間後には情報の鮮度が低下した状態となり、正常な確認がないまま24時間経過するとイベントの検索結果を返さなくなります。同期に失敗した場合はサービスエラーを返し、イベントが存在しないという誤った結果は返しません。

サービスは無料で利用できます。安定した稼働と運用コストを守るため、調整可能な利用上限と処理上限を設けています。上限に達した場合は、時間をおいて再試行するか、Salsa Vidaを直接ご覧ください。公開エンドポイントへのリクエストが、そのまま稼働中のWordPressの検索に転送されることはありません。

利用上限

公開当初の上限は、ネットワークIPごとに毎分約120回のツール呼び出し、標準で20件の結果、1ページあたり最大50件、1回の検索につき最大10ページです。リクエストは16 KB、応答は128 KBまでです。ページ分割や結果の省略は明示します。結果が省略された場合は、検索条件を絞り込んでください。同じネットワークを使う利用者同士で上限を共有することがあります。上限は需要や不正利用の状況に応じて変更する場合があります。

通常のMCPエラー処理を行い、再試行の案内に従ってください。短時間での繰り返し再試行、大量複製、アクセス制限を回避する行為は避けてください。

出典表記とサイトへのアクセス

Salsa Vidaの検索結果を利用するときは、出典をSalsa Vidaと明記し、関連するイベントまたはガイドへのリンクを添えてください。各結果には、計測用タグのない正規URLと、タグ付きの訪問用URLが含まれます。出典表記には正規URLを使い、任意で「Salsa Vidaで見る」という操作を設ける場合は訪問用URLを使ってください。不完全な情報や定期開催の情報を、独立した確認が済んでいるかのように示さないでください。

ツールが呼び出されたことだけでは、アシスタントが結果を引用したことや、人がウェブサイトを訪れたことは確認できません。タグ付きの訪問リンクを使うことで、確認できるサイト訪問を別に計測できます。

プライバシー

利用状況について、ツール名、選択された地域ID、表記を整えた短い地名検索、ダンス、サルサのスタイル、イベントの種類、言語、計画の対象期間、結果件数、応答時間、エラー、キャッシュの状態、クライアントが自己申告した名前を簡潔な計測データとして記録します。クライアント名の真正性は確認していません。サービスの利用分析に会話の全文、リクエストや応答の本文全体、生のIPアドレスは保存しません。不正利用の制限を適用するため、ネットワークアドレスを一時的に処理する場合があります。

サービスのホスティングと分析処理はCloudflareが行います。ツール利用の詳細データは最大3か月間、日次の集計データは25か月間保持します。プロバイダーによるサンプリングのため、件数が推計値になる場合があります。タグ付きリンクには、Salsa Vidaのプライバシーポリシーに基づく通常のウェブサイト分析が適用されます。

Smithery経由で接続すると、そのゲートウェイがSalsa Vidaへのリクエストを中継する場合があります。この接続にはSmitheryのプライバシーポリシーと利用規約も適用されます。上記の直接接続用エンドポイントの利用にSmitheryは必要ありません。

利用規約とサポート

このサービスは、ダンスイベントや目的地を見つける手助けを目的としています。公開アクセスが可能であっても、Salsa Vidaのデータベース全体の再公開や、著作権で保護された説明文の大規模な複製を許可するものではありません。出典表記、公開されている上限、Salsa Vidaの利用規約を守ってください。イベント情報は変更される場合があり、サービスの利用可能性は保証されません。

連携に関するご質問、情報の訂正、アクセスの問題は、Salsa Vidaへお問い合わせください。ツール名、リクエストのおおよその時刻、機密情報を含まない問題の説明を添えてください。非公開の会話や認証情報は送らないでください。