TypeHop
ダウンロード

開発者 · APIキー

TypeHop APIキーリファレンス

APIキーを使うと、AIアプリやあなた自身のコードから、どのデバイスでもTypeHopアカウントに同期されたディクテーションを読み取れます。キーは読み取り専用で、ディクテーションやカスタム単語の検索と読み取りはできますが、変更や削除は一切できません。アクセスは1つのリモートMCPエンドポイント経由なので、Claude Code、Cursor、Codexなどのアプリは1行の設定だけで使えます。

キーを作成する

  1. TypeHopのMacアプリを開き、Integrations → API keysに移動します。
  2. Press Create API keyを押し、使用するアプリやマシンの名前(例:「ノートPCのCursor」)を付けます。
  3. キーはすぐにコピーしてください。TypeHopが保存するのはハッシュだけなので、完全なキーが表示されるのは一度だけです。紛失した場合は、新しいキーを作成して古いキーを無効化してください。

キーは thp_mcp_ で始まります。アプリの一覧には、各キーの先頭の文字、作成日時、最終使用日時が表示されます。キーを無効化すると、そのキーを使っているすべてのアプリが直ちに使えなくなります。

認証

すべてのリクエストで、キーをBearerトークンとして送信します。OAuthのフローや、開くべきセッションはありません。

エンドポイント
https://api.typehop.com/v1/mcp
メソッド
POST のみ。GET と DELETE は405を返します。
ヘッダー
Authorization: Bearer thp_mcp_YOUR_KEY
ボディ
JSON-RPC 2.0、Content-Type: application/json

キーがない、または無効化されている場合

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="typehop-mcp"

{ "jsonrpc": "2.0", "id": null, "error": { "code": -32001, "message": "This token is invalid or was revoked." } }

AIアプリを接続する

ほとんどの方は、エンドポイントを手動で呼び出すことはありません。MacアプリのConnect an appには、Claude Code、Cursor、VS Code、Windsurf、Codex、Gemini CLI、Zed、Claude Desktop向けの正確な設定が、新しいキーが入力済みの状態で表示されます。同じスニペットはMCPページにもあります。例としてClaude Codeの場合:

claude mcp add --transport http typehop https://api.typehop.com/v1/mcp --header "Authorization: Bearer thp_mcp_YOUR_KEY"

Streamable HTTPでリモートMCPサーバーに対応しているクライアントなら、エンドポイントのURLと上記のヘッダーでそのまま使えます。Claude.aiとChatGPTのカスタムコネクタにはOAuthが必要ですが、TypeHopはまだ対応していません。

コードから呼び出す

エンドポイントはModel Context Protocolに対応しています。POSTでJSON-RPC 2.0メッセージを送ると、JSONレスポンスが1つ返ります。ステートレスなので、セッションヘッダーもServer-Sent Eventsもありません。対応するプロトコルバージョン: 2025-06-18, 2025-03-26, 2024-11-05.

1. 初期化(任意ですが、MCPクライアントは実行します)

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

2. ツールを一覧表示する

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. ツールを呼び出す

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_dictations","arguments":{"query":"launch plan","limit":5}}}'

レスポンス · 200

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[2026-11-03T09:14:22.000Z · Slack · id 3f6c1a2e-8b1d-4c55-9a0e-6b2f7d1e4c90]\nThe launch plan moves to next Tuesday..."
      }
    ],
    "isError": false
  }
}

結果に含まれる各ディクテーションは、ヘッダー行 [created at · app · id <id>] で始まり、その後に整形済みのテキストが続きます。そのidを get_dictation に渡すと、元のトランスクリプトを取得できます。1回のリクエストで最大20件のメッセージを配列として送ることもできます。通知(id のないメッセージ)にはボディなしで 202 が返ります。ping にも対応しています。

ツール

すべてのツールは読み取り専用で、result.content[0].text にプレーンテキストを返します。

search_dictations · ディクテーションを検索

ユーザーがこれまでにディクテーションしたすべての内容を全文検索します。新しい一致から順に返します。

  • query (string、必須): 検索する単語またはフレーズ。
  • limit (integer 1–50、デフォルト 20)

recent_dictations · 最近のディクテーション

ユーザーの最新のディクテーション。必要に応じて、直近の数日分に絞り込めます。

  • limit (integer 1–50、デフォルト 20)
  • days (integer 1–365): 直近N日間のディクテーションのみ。

get_dictation · ディクテーションを取得

idで指定した1件のディクテーション。整形済みのテキストと元のトランスクリプトを返します。

  • id (string、必須): 検索結果または最近の結果に表示されるid。

list_dictionary · カスタム単語

ユーザーのカスタム単語と表記(名前、専門用語)。

引数なし。

ツールが回答できない場合(空のクエリ、不明なid、一時的な読み取りの失敗)でも、応答は200の結果として返り、isError: true とモデルが読める1文が含まれます。

エラー

プロトコルエラーは、JSON-RPCの error オブジェクトとして返されます:{ "code": <number>, "message": "<text>" }。

  • 401 · -32001 Authorizationヘッダーがない、またはキーが無効、もしくは無効化されています。
  • 400 · -32700 ボディが有効なJSONではありません。
  • 413 · -32600 ボディが256 KBを超えています。
  • 200 · -32600 メッセージがJSON-RPC 2.0ではありません("jsonrpc": "2.0" または "method" がありません)。
  • 200 · -32601 不明なメソッドです。
  • 200 · -32602 tools/call で存在しないツールが指定されました。
  • 500 · -32603 サーバーエラー。バックオフを入れて再試行してください。

制限とセキュリティ

有効なキー
1アカウントにつき最大10個。新しく作成するには、1つを無効化してください。
リクエストサイズ
1リクエストあたり256 KB、1バッチあたり最大20メッセージ。
結果
1回の呼び出しで最大50件のディクテーション。recent_dictations がさかのぼれるのは最大365日です。
対象範囲
アカウントに同期されたディクテーションとカスタム単語。書き込みは一切行われません。
  • アプリやマシンごとに1つのキーを使うと、他に影響を与えずに1つだけ無効化できます。
  • キーはお使いのコンピュータやバックエンドに保管してください。ブラウザのコード、モバイルアプリのバンドル、公開リポジトリには絶対に入れないでください。
  • キーが漏えいした場合は、Integrations → API keys で無効化してください。次のリクエストから使えなくなります。

お問い合わせ: support@typehop.com。概要をお探しの場合は、TypeHop APIをご覧ください。

Other products from us:SmashSend·TidySupport·SuperBuilder·Inbounter·Blossu·KnowledgeSDK