Tolk2Go Interpreter Booking

Tolk2Go エージェントアクセス

Tolk2Go は、顧客と、対面・電話・ビデオでの通訳業務に対応する宣誓済みの有資格通訳者をつなぎます。このリポジトリを使うと、AI エージェントが顧客アカウントに代わって Tolk2Go の通訳者を予約・管理できます。

• MCP サーバー： https://api.tolk2go.com/api/v1/mcp（ストリーミング可能な HTTP）
• REST API（OpenAPI 3）： https://api.tolk2go.com/api/v1/spec
• エージェントガイド： https://www.tolk2go.com/llms.txt
• エージェントスキル： skills/booking-tolk2go-interpreters

アクセスの仕組み

検索は公開されています。予約操作は顧客アカウントに紐づいており、エージェントキーを使用します。

1. tolk2go.com または POST /api/v1/register からアカウントを作成します。

2. 1 回ログインして、5 分間有効なトークンを取得します。

   curl -s -X POST https://api.tolk2go.com/api/v1/login \
     -H 'Content-Type: application/json' \
     -d '{"email":"[email protected]","password":"..."}'
   

3. そのトークンを使って、有効期間の長いエージェントキーを発行します（デフォルトは 90 日で、7～365 日を指定できます）。平文のキーが表示されるのは一度だけです。

   curl -s -X POST https://api.tolk2go.com/api/v1/agent-access-keys \
     -H "Authorization: Bearer $LOGIN_TOKEN" \
     -H 'Content-Type: application/json' \
     -d '{"name":"My assistant","expires_in_days":90}'
   

4. 返された key をクライアントのシークレットストアに保存し、Authorization: Bearer <key> として送信します。

キーの一覧表示、ローテーション、取り消しには、新しいログイントークンを使用できます。キーを紛失してもアカウントにアクセスできなくなることはありません。再度ログインして、新しいキーを発行してください。

MCP クライアントを接続する

{
  "mcpServers": {
    "tolk2go": {
      "type": "http",
      "url": "https://api.tolk2go.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer t2g_agent_..." }
    }
  }
}

initialize と tools/list はキーなしで使用できるため、まずツールを確認できます。すべてのツール呼び出しには有効なキーが必要です。

ツール	目的
tolk2go_interpreting_list_bookings	アカウントの予約一覧、またはタイムスタンプ／カーソル以降の変更のみを取得します
tolk2go_interpreting_get_booking	予約、支払い、変更、次のアクションの状態を確認します
tolk2go_interpreting_get_responses	対応可能と回答した通訳者を確認します
tolk2go_interpreting_create_booking	通訳者の依頼を作成します
tolk2go_interpreting_select_interpreter	対応可能な通訳者を選択します（支払いリンクが返される場合があります）
tolk2go_interpreting_request_change	顧客の承認フローを通じて変更を申請します
tolk2go_interpreting_cancel_booking	予約をキャンセルします

まず公開 REST エンドポイントで、言語、状況、対応可能な通訳者を確認してください。全体の手順については、スキルと llms.txt を参照してください。

エージェントスキルをインストールする

npx skills add Tolk2Go-Organization/agent-skills

または、skills/booking-tolk2go-interpreters/SKILL.md をエージェントのスキルディレクトリにコピーしてください。

サポート

[email protected] · 利用規約