Claude MCP

Model Context Protocol (MCP) は、Claude などの AI アシスタントが外部ツールを呼び出せるようにするオープン標準です。Finn は MCP サーバーを提供しているため、Claude を Finn アカウントに接続すれば、ビルダーを手作業で埋める代わりに、会話で内容を伝えるだけで音声エージェントを作成できます。

このサーバーでできること。 Finn の読み取りと、下書きの作成・編集だけです。Finn の公開、発信、残高の消費、連絡先の操作、文字起こしの閲覧はできません。これらは意図的にダッシュボードに限定しています。理由は後述の スコープ セクションで説明します。

対象ユーザー。 すでに Claude を使っていて、エージェントをクリック操作で組み立てるより言葉で説明したい方。コードを書く必要はありません。Claude を使っていなくても困ることはありません。ここで公開されている機能はすべてダッシュボードで利用でき、ダッシュボードではさらに多くの操作が可能です。

接続方法は 2 つだけで、どちらか一方を使えば十分です。

スコープ — サーバーでできること・できないこと

これは意図的な設計で、2 か所で制限しています。サーバーはこれらのツールを公開せず、仮に何かが要求してきても、バックエンドが該当するリクエストを拒否します。理由は後述のコネクタリンクにあります。このリンク自体が認証情報なので、漏洩した場合でも被害は Finn の閲覧と下書きの編集にとどまります。これなら元に戻せます。「顧客に電話をかけて残高を使う」ことは元に戻せません。

つまり、Claude が作成し、公開はあなたが行います。 Finn はすべて下書きとして作成されるので、ダッシュボードで内容を確認してから、ボタンを押して公開してください。

ステップ 1 — キーを生成する

ダッシュボードで 設定 → 連携 → AI アシスタント (MCP) → キーを生成 を開きます。

キーに付けた名前が、Claude 内でのコネクタの表示名になります。「仕事用ノート PC」「自宅のデスクトップ」など、使用する場所に合わせて名前を付けてください。そうすれば、キーが 2 つあっても同じ行が 2 つ並ぶのではなく、区別できる 2 つの項目として表示されます。

キーは finn_mcp_ で始まる長い文字列です。キーは一度しか表示されません。 ダイアログを閉じる前に必要な値をコピーしてください。紛失した場合は、そのキーを無効化して新しいキーを生成してください。

キーについて知っておきたいポイント:

• キーはあなたの ID と結び付いています。 あなたのキーで作成した Finn は、あなたの名義であなたの組織に作成されます。同僚のキーを使うと、Finn は同僚のアカウントに作成され、あなたからは見つけられません。
• スコープや権限レベルはありません。 どのキーでも、上記の「できること」はすべて実行でき、「できないこと」は一切実行できません。
• 取り消しは即時に反映されます。 サーバーは呼び出しのたびにキーをアカウントと照合するため、取り消したキーはセッションの終了時ではなく、次のリクエストの時点で使えなくなります。

ステップ 2 — Claude を接続する

新しいキーを表示するダイアログには、両方の方法がそれぞれコピーボタンとして用意されています。Claude の使い方に合うほうを選んでください。

方法 1 — Claude アプリ（claude.ai または Claude Desktop）

ほとんどの方にはこちらが適しています。インストールも編集も不要です。

ダイアログからコネクタリンクをコピーします。末尾にご自身のキーが付いた、次のような形式です:

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

次に、Claude で以下の操作を行います:

1. Customize → Connectors を開き、+ をクリックして Add custom connector を選択します。
2. リモート MCP サーバーの URL としてリンクを貼り付け、Add をクリックします。キーの名前で一覧に表示されます。
3. 新しいチャットで + → Connectors を開いて Finn をオンにし、Claude に Finn の作成を依頼します。

プランに関する注意点が 2 つあります。Free プランで追加できるカスタムコネクタは 1 つだけです。また、Team プランと Enterprise プランでは、Organization settings → Connectors から追加できるのは Owner のみで、その他のメンバーは追加されたコネクタの Connect をクリックします。

注意点: カスタムコネクタには URL の入力欄しかなく、パスワードを設定する場所がないため、リンクそのものが認証情報になります。URL 全体をダッシュボードのパスワードと同じように扱い、チャット、チケット、スクリーンショット、リポジトリには貼り付けないでください。

方法 2 — Claude Code（ターミナル）

ダイアログからコマンドをコピーします。1 行のコマンドなので、bash、zsh、PowerShell、cmd のいずれにもそのまま貼り付けられます:

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

1. ターミナルにコマンドを貼り付けて実行します。
2. claude を実行します。
3. Finn の作成を依頼します。

この方法ではキーを URL ではなくヘッダーに含めるため、2 つの方法のうちより安全です。

その他の MCP クライアント

サーバーは stdio ではなく streamable HTTP で通信し、ステートレスです。開始したり期限切れになったりするセッションはありません。HTTP MCP エンドポイントに対応したクライアントであれば、上記 2 つの接続方法のどちらでも利用できます。/mcp に対して Authorization: Bearer ヘッダーでキーを渡す方法と、/mcp/<key> のパスの最後のセグメントとしてキーを指定する方法です。

claude_desktop_config.json は選択肢に含まれません。このファイルはローカルの MCP サーバーを設定するためのものです。Finn サーバーはリモートのため、代わりにカスタムコネクタとして追加します。

ステップ 3 — 動作を確認する

Claude に次のように質問します:

「Finn は何がありますか？」

正しく接続されていれば、実際の Finn の名前が返されます。該当するツールがないと Claude が答えた場合は、下のトラブルシューティングを参照してください。

ツール

ツールは 6 つあり、Claude が自動で使い分けます。ツール名を直接指定する必要はありません。

会話で Finn を作成する

作りたいものを普段の言葉で依頼します。ダイアログには、たたき台として次の例が表示されます。

「Finn コネクタを使って、歯科医院の予約を受け付ける Maya という名前の下書き Finn を作成して。親しみやすく簡潔に、英語で。」

より詳しく依頼する場合は、次のようになります。

「営業チーム向けに 15 分のデモ通話を予約する Skylar という Finn を作成して。温かみがあって簡潔、相手の話を遮らず、日時は必ず発信者に復唱して確認すること。話題はデモとスケジュール調整だけに限定し、料金について聞かれたら担当者への引き継ぎを提案すること。親しみやすい女性の英語音声を使って。」

これを実行するには、Claude に次の 4 項目が必要です。いずれかが抜けている場合は Claude が確認します。

必要に応じて、ユースケースのラベル、言語、音声、冒頭のセリフ、そして誤って発音されやすい名前のためのカスタム語彙リストも指定できます。

作成されると、新しい下書きへのリンク、その ID、作成先の組織とアカウントが返されます。その後の手順は次のとおりです。

1. リンクを開き、ビルダーで内容を確認します。
2. Claude に変更を依頼します（「冒頭のセリフを短くして」「留守番電話用の分岐を追加して」など）。下書きはその場で編集されます。
3. 内容に問題がなければ、ダッシュボードで番号を割り当てて公開します。Deployments を参照してください。

すでに開いていたダッシュボードのタブには、再読み込みするまで新しい Finn は表示されません。

音声

「落ち着いた男性の英語音声」のように特徴を伝えて音声を依頼すると、Claude がカタログを検索します。

注意点が 1 つあります。新しい Finn は Cartesia 上で作成されます。別のプロバイダーの音声 ID を指定してもエラーなく保存されますが、実際の通話で失敗します。特定のプロバイダーを指定する場合は、その Finn が実際に使用しているプロバイダーであることを確認してください。カタログの全体は Voice Gallery で確認できます。

セキュリティ

コネクタのリンクはパスワードと同じです。 リンク 1 つで設定する方式ではキーが URL に含まれるため、URL を見た人は誰でもあなたと同じアクセス権を得られます。スクリーンショットを撮ったり、共有チャットに貼り付けたり、コミットしたりしないでください。

貼り付けた内容はすべて漏洩したものと考えてください。 チャット画面、チケット、メールに一度でも載ったキーは失効させ、新しいキーを発行してください。コストはかかりません。

失効は「設定 → 連携 → AI アシスタント → 失効」から行います。 次のリクエストから反映されます。作成済みの Finn はそのまま残ります。キーを失効させても、そのキーで作成したものは削除されません。

キーは利用場所ごとに 1 つずつ。 ノート PC、デスクトップ、同僚ごとにキーを分けておけば、1 つを失効させても他に影響しません。どのキーがどこで使われているかはコネクタ名で判別できます。

どのアカウントを使っているか確認してください。 複数の組織に所属している場合は、何かを作成する前に Claude に「どの Finn 組織にいますか？」と尋ねてください。新しい Finn は、最後に参加した組織に作成されます。

トラブルシューティング

「Claude に Finn のツールが表示されない」

• Claude アプリでは、チャットで + → コネクタ を開き、Finn がオンになっているか確認してください。コネクタは会話ごとに有効化されます。
• Claude Code の場合は再起動してください。MCP の設定は起動時に読み込まれます。
• Free プランの場合は、1 つしかないカスタムコネクタの枠を他で使っていないか確認してください。

「このコネクタリンクは無効です」

URL 内のキーの形式が正しくありません。finn_mcp_ から始まるキー全体が必要です。末尾が欠けていないこと、末尾にスラッシュやスペースがないことを確認してください。

「このコネクタリンクは失効しています」

そのキーはすでに存在しません。新しいキーを発行し、コネクタを更新してください。

「キーを検証するために Finn のバックエンドに接続できませんでした」

設定の問題ではなく、当社側の一時的な問題です。もう一度お試しください。解決しない場合はサポートにお問い合わせください。

Claude が Finn を作成したのに見つからない

ほとんどの場合、アカウントの取り違えが原因です。Claude に「どの組織に作成しましたか？」と尋ねると、組織名とキーの所有者のメールアドレスが返ってきます。自分のものでなければ、他人のキーを使っています。

Claude が Finn を編集できないと言う

その Finn はすでに公開されています。サーバーで編集できるのは下書きのみです。公開中の Finn はダッシュボードで編集してください。

次のステップ

• Finn の作成 → — ダッシュボードのビルダーと、各ペルソナ項目の役割。
• デプロイ → — 番号の割り当てと、下書きの公開。
• ボイスギャラリー → — 全ボイスの一覧。
• 連携 → — Webhook をはじめとする連携機能。