開発者 · APIキー
TypeHop APIキーリファレンス
APIキーを使うと、AIアプリやあなた自身のコードから、どのデバイスでもTypeHopアカウントに同期されたディクテーションを読み取れます。キーは読み取り専用で、ディクテーションやカスタム単語の検索と読み取りはできますが、変更や削除は一切できません。アクセスは1つのリモートMCPエンドポイント経由なので、Claude Code、Cursor、Codexなどのアプリは1行の設定だけで使えます。
キーを作成する
- TypeHopのMacアプリを開き、Integrations → API keysに移動します。
- Press Create API keyを押し、使用するアプリやマシンの名前(例:「ノートPCのCursor」)を付けます。
- キーはすぐにコピーしてください。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 · -32001Authorizationヘッダーがない、またはキーが無効、もしくは無効化されています。400 · -32700ボディが有効なJSONではありません。413 · -32600ボディが256 KBを超えています。200 · -32600メッセージがJSON-RPC 2.0ではありません("jsonrpc": "2.0" または "method" がありません)。200 · -32601不明なメソッドです。200 · -32602tools/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をご覧ください。