Claude MCP

Model Context Protocol (MCP) は、Claude のような AI アシスタントが外部ツールやデータソースに安全にアクセスできるようにするオープン標準です。Finn は MCP サーバーを公開しているため、Finn を Claude（または MCP 対応クライアント）に接続し、AI アシスタントから対話形式でプラットフォームの照会・設定・操作を行えます。

対象ユーザー。 これはパワーユーザー向けです。Claude Desktop、Claude Code、その他の MCP クライアントから Finn を操作したい開発者、自動化エンジニア、AI に精通した運用担当者を想定しています。Claude や MCP に馴染みがない場合は不要です。MCP で提供される機能はすべてダッシュボードで実行できます。

ステータス: Finn MCP サーバーはパブリックベータです。API は安定していますが、ツールは継続的に追加されています。

MCP でできること

接続すると、Claude（または他の MCP 対応 AI）が以下の操作をユーザーに代わって実行できます。

読み取り操作

• 任意のデプロイメントのステータスを取得する。
• Finn、オーディエンス、電話番号の一覧を表示する。
• 任意の期間の通話記録と分析データを取得する。
• 特定のパターンで通話履歴を検索する（「発信者が『返金』と言及した通話を表示」など）。
• デプロイメントのコスト、プラン使用量、請求サマリーを確認する。

書き込み操作

• 新しいデプロイメントを開始する。
• 実行中のデプロイメントを一時停止または停止する。
• オーディエンスに連絡先を追加する。
• Finn の通話後分析フィールドを更新する。
• 番号を抑制する（発信拒否リストに追加）。

連携処理

• 週次・月次レポートを自動生成する。
• 通話結果を CRM と突き合わせ、アトリビューションの欠落を検出する。
• CRM のリストが一定の件数に達したら新しいデプロイメントを自動作成する。
• デプロイメントを平易な言葉で要約し、技術者以外の関係者と共有できる形にする。

MCP サーバーのセットアップ

ステップ 1 — MCP トークンを生成する

設定 → 連携 → MCP → トークンを生成。

トークンは一度しか表示されないため、すぐにコピーしてください。パスワードマネージャーまたはシークレットストアに保管します。

トークンのスコープは設定可能です:

• 読み取り専用 — データの照会は可能、変更は不可
• 読み取り + 書き込み — 完全な操作権限（要注意）
• 特定の Finn／オーディエンスに限定 — アクセス範囲を一部に制限

ほとんどのユーザーは、まず 読み取り専用 で慣れてから範囲を広げることをおすすめします。

ステップ 2 — MCP クライアントを設定する

Claude Desktop（Mac、Windows）:

Claude Desktop の設定ファイルを編集します:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Finn サーバーを追加します:

{
  "mcpServers": {
    "finnai": {
      "command": "npx",
      "args": ["-y", "@finnai/mcp-server"],
      "env": {
        "FINNAI_API_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop を再起動します。これで、どの会話でも Finn のツールが利用できます。

Claude Code (CLI):

claude mcp add finnai \
  --command "npx -y @finnai/mcp-server" \
  --env FINNAI_API_TOKEN=your_token_here

次に任意のディレクトリで claude を実行すると、Finn のツールが利用できます。

その他の MCP クライアント（Continue、Cursor、カスタム）:

クライアントの MCP サーバー設定で同じ npx コマンドを使用します。サーバーは stdio 経由の標準 MCP で通信します。

ステップ 3 — 接続をテストする

Claude（任意のクライアント）で次のように尋ねます:

「設定済みの Finn は何がありますか？」

接続が機能していれば、Claude が list_finns ツールを呼び出し、実際の内容を返します。

MCP が公開するツール

サーバーは約 30 個のツールを提供します。主なものは以下のとおりです。

Finn の管理

• list_finns — アカウント内のすべての Finn を一覧表示します。
• get_finn — 1 つの Finn の完全な設定を取得します。
• create_finn — 新しい Finn を作成します（上級者向け）。
• update_finn — Finn の設定を変更します。

オーディエンスの管理

• list_audiences — すべてのオーディエンスを一覧表示します。
• get_audience_stats — 件数、検証ステータス、最近のインポート。
• add_contacts — 連絡先を一括追加します。
• remove_contact — 連絡先を 1 件削除します。

デプロイメントのライフサイクル

• list_deployments — 過去およびアクティブなデプロイメントを一覧表示します。
• launch_deployment — 新しいデプロイメントを開始します。
• pause_deployment / resume_deployment / stop_deployment。
• get_deployment_status — 現在の通話数を含むライブステータス。

分析

• get_deployment_analytics — デプロイメントの全メトリクス。
• search_calls — 内容パターンに一致する通話を検索します。
• get_call — 1 件の通話の文字起こしと分析を取得します。
• aggregate_calls — 任意のフィールド・任意の期間によるカスタム集計。

コンプライアンス

• add_to_suppression_list — 番号を全体でブロックします。
• remove_from_suppression_list — ブロックを解除します。
• check_suppression — 番号がリストに含まれているか確認します。

請求

• get_usage_this_month — 現在の利用額。
• forecast_month_end — 推移に基づく予測。
• set_spend_cap — 上限を調整します。

各ツールの完全なスキーマ: api.hirefinn.ai/academy/mcp。

Claudeに依頼できること

実際に使えるプロンプト例：

「昨日のデプロイメント結果を表示して、どのFinnが最も成果を出したか教えて。」

「先週の通話のうち、発信者が『高すぎる』と言ったものをすべて見つけて、共通する文脈を要約して。」

「先週の月曜日と同じデプロイメントを、今朝アップロードした新しいオーディエンスに対して実行して。」

「先週の支出はいくらで、予算に対して順調ですか？」

「次の電話番号を抑止リストに追加して：[リストを貼り付け]」

「午前中の通話と午後の通話で、成功率にどのくらい差がありますか？」

「先月のアポイントメントリマインダーキャンペーンについて、クリニック管理者向けに1ページの要約を作成して。」

MCPによりFinnを対話的に操作できます。ダッシュボードで5〜10回のクリックを要する操作が、自然言語による1回の依頼で完了します。

セキュリティに関する考慮事項

トークンでできること

許可される操作はトークンのスコープによって決まります：

• 読み取り専用トークン → すべてを照会できるが、変更はできない。
• 読み取り＋書き込み → すべての運用操作が可能。ダッシュボードのパスワードと同等に扱ってください。
• スコープ付きトークン → Finn ID、オーディエンスID、操作種別で制限。

ベストプラクティス

• トークンをチャットメッセージに貼り付けないでください。 MCPクライアントの設定で環境変数を使用します。
• トークンを定期的にローテーションしてください。 設定 → 連携 → MCP → ローテーション。
• チームメンバーにはスコープ付きトークンを使用してください。 業務委託先にフルアクセストークンを渡さないでください。
• 監査ログ。 すべてのMCP呼び出しが記録されます。設定 → 連携 → MCP → アクティビティログ。
• 漏洩した場合はただちにトークンを失効させてください。 設定 → 連携 → MCP → 失効。

Claudeにできないこと

MCPでは次の操作を提供していません：

• アカウントの作成・削除
• 支払い方法の変更
• プランのアップグレード・ダウングレード
• チームメンバーの招待
• SSOの設定

これらはダッシュボードからの操作が必要です。人間が判断すべき事項であるため、意図的にそうしています。

機微な操作の承認

デフォルトでは、MCPはすべての書き込み操作について、MCPクライアントの権限機能を通じた明示的な人間の承認を必要とします：

• デプロイメントの実行
• 連絡先の追加・削除
• Finn設定の変更
• 費用の発生

これはプロトコルレベルで強制されます。クライアントUIで確認しない限り、Claudeが書き込みを実行することはできません。読み取り操作に承認は不要です。

ツールごとに自動承認するには、設定 → 連携 → MCP → 自動承認リスト で無効化できます。使用は最小限に。「launch_deployment」の自動承認は、短時間で多額の費用が発生する原因になります。

よくあるパターン

デイリースタンドアップ

毎朝、前日の指標を取得するように Claude を設定します。

「平日は毎日午前9時に、前日のデプロイ結果を要約し、異常があれば強調して、Slack に投稿して。」

（Claude Code のスケジュールタスク、または独自の cron + MCP ラッパーが必要です。）

異常検知

「直近24時間のデプロイで、成功率が50%を下回ったもの、またはコストが7日間平均の2倍を超えたものがあるか確認して。該当するものを詳細付きでフラグ付けして。」

一括監査

「通話後分析フィールドが未定義の Finn をすべて一覧表示して。各 Finn のアイデンティティ説明をもとに、妥当なデフォルト値を提案して。」

クイックエクスポート

「デプロイ X の通話のうち qualified=true のものをすべて抽出し、CSV でエクスポートしてメールで送って。」

トラブルシューティング

「Claude が Finn のツールを見つけられない」

• 設定を編集した後は Claude Desktop を再起動してください。
• 設定 JSON が有効か（カンマ、引用符）確認してください。
• ターミナルで npx -y @finnai/mcp-server --test を実行し、サーバーが起動することを確認してください。

「認証に失敗しました」

• トークンが期限切れまたは失効しています。新しいトークンを生成してください。
• トークンの環境変数が渡されていません（設定の記述ミス）。

「ツール呼び出しがタイムアウトしました」

• 大量のクエリ（通話履歴の検索など）は30秒以上かかることがあります。
• ほとんどのクライアントのデフォルトタイムアウトは30秒です。必要に応じて延長してください。

「ツール X の権限がありません」

• トークンのスコープにこのツールが含まれていません。
• より広いスコープのトークンを再生成するか、その操作にはダッシュボードを使用してください。

今後の予定

MCP のロードマップ（本記事執筆時点）:

• ワークフローツール — Claude からビジュアルワークフローを作成・編集。
• Test-on-Call ツール — Claude からテスト通話を発信。
• ストリーミングサブスクリプション — ライブデプロイ向けのリアルタイムイベントストリーム。
• マルチアカウント対応 — 1つの Claude セッションから複数の Finn アカウントを管理。
• 録音再生 — 通話音声を Claude にストリーミングして直接再生（Enterprise）。

希望するツールは [email protected] までお寄せください。

Claude 以外

本ページでは Claude を中心に説明していますが、MCP サーバーはプロバイダー非依存です。以下でも動作します。

• Continue.dev（VS Code AI 拡張機能）
• Cursor（AI ファーストの IDE）
• OpenAI ChatGPT Desktop（MCP 対応が提供され次第）
• オープン仕様に基づくカスタム MCP クライアント

MCP に対応したクライアントであれば、同じサーバー経由で Finn を利用できます。

次のステップ

• 連携 → REST API — MCP がラップしている基盤 API。
• 連携 → Webhook — イベント駆動型ワークフロー向けのプッシュ通知。
• キャパシティとスケール → — MCP 呼び出しに適用されるレート制限。