Vocenya Site

Vocenya MCP サーバー

Claude、ChatGPT、Cursor、VS Code、その他の AI アシスタントを、GH Business Solutions が提供する中小企業向け AI 電話受付サービスの Vocenya と、その開発者向けドキュメントに接続します。

Vocenya は電話とウェブサイトのチャットに 24 時間 365 日対応し、予約を受け付け、見込み客情報を取得し、通話を訓練を受けた担当者に引き継ぎ、Do Not Call、同意、発信可能時間のチェックを行ったうえで AI による発信を実施します。Streamable HTTP 経由で 3 つのリモートモデルコンテキストプロトコルサーバーを実行します。インストールは不要です。クライアントから URL を指定するだけです。

詳細ガイド：https://vocenya.com/docs/mcp

サーバー	URL	認証	機能
Vocenya Docs	https://vocenya.com/mcp/docs	なし	Vocenya の開発者向けドキュメントを検索し、すべての REST エンドポイントとコードサンプルを取得します。読み取り専用です。
Vocenya (platform)	https://vocenya.com/mcp/platform	OAuth または API キー	1 つのビジネスアカウントの通話、見込み客、予約、チャットを確認できます。見込み客の追加、AI 発信のキュー登録、Do Not Call リストの更新も可能です。
Vocenya Site	https://vocenya.com/mcp/site	なし	vocenya.com の情報をもとに、Vocenya 自体について回答します。プランと料金、製品、業種、拠点、ガイドが対象です。読み取り専用です。

公開サーバーのリクエスト数は、IP アドレスごとに 1 分あたり 60 件までです。platform サーバーは API キーの REST リクエスト制限（デフォルトではキーごとに 1 分あたり 120 件）を共有します。

このリポジトリには、公式 MCP レジストリのエントリー、Claude Code プラグイン、これらの手順が含まれています。サーバーは Vocenya がホストしており、コードはこのリポジトリにはありません。

ツール

Vocenya Docs（キー不要、読み取り専用）

ツール	機能
search_docs	ガイド（認証、Webhook、ページネーション、アウトバウンド発信ルール、ライブチャット、MCP）とすべての API エンドポイントを検索します。
get_doc_page	ドキュメントのページを Markdown 形式で取得します。例：quickstart、webhooks、reference/leads。
list_endpoints	メソッド、パス、概要、必要なスコープを含む REST エンドポイントをリソースごとにまとめて表示します。
get_endpoint	1 つのエンドポイントの情報をすべて取得します。スコープ、パラメーター、リクエストボディ、レスポンス、cURL、Node、PHP、Python のコードサンプルが含まれます。

Vocenya platform（OAuth または API キー）

ツール	スコープ	機能
list_calls	calls:read	AI、GH Live エージェント、またはチームが対応した通話を新しい順に表示します。
get_call	calls:read	リード情報を含む1件の通話を取得します。アカウントが HIPAA モードの場合を除き、AI による要約と文字起こしも取得できます。
list_leads	leads:read	通話、チャット、フォームからのリードを表示します。
get_lead	leads:read	連絡先の詳細、理由、緊急度、流入元を含む1件のリードを取得します。
create_lead	leads:write（AI に折り返し電話を依頼する場合は outbound:write も必要）	別のシステムからリードを追加します。任意で、AI に折り返し電話を依頼できます。
list_bookings	bookings:read	AI がビジネスのカレンダーに登録した予約を表示します。
list_chats	chats:read	Web サイトのライブチャットの会話を表示します。
queue_outbound_call	outbound:write	同意を得た相手に AI から電話をかけるよう依頼します。先にコンプライアンスを確認し、拒否された場合は理由を返します。
add_do_not_call	dnc:write	ビジネスの発信拒否リストに電話番号を追加します。

各ツールは、それぞれのスコープ（API キーのスコープ、または OAuth 接続時にアカウント所有者が承認したスコープ）を確認します。そのため、leads:read のみを持つキーではリードを読み取れますが、通話をキューに登録することはできません。テストキー（vk_test_...）は分離されたサンプルデータで動作し、実際に誰かの電話を鳴らすことはありません。HIPAA モードのアカウントでは、MCP を通じて文字起こし、AI による要約、チャットメッセージが返されることはありません。

Vocenya Site（キー不要、読み取り専用）

get_pricing、get_service、search_industries、get_industry、list_locations、search_articles、get_article、およびリソース vocenya://llms.txt。

認証

• Docs と Site： 不要です。
• Platform、OAuth（キー不要）： OAuth でサインインするクライアント（Claude Code、Claude コネクタ、ChatGPT 開発者モードなど）には URL だけが必要です。クライアントが自身を登録した後、アカウント所有者が Vocenya にサインインし、アカウント、ライブデータまたはテストデータ、権限（API キーと同じスコープ）を選択します。所有者は Developers ページ（https://vocenya.com/app/developers）で、接続済みアプリを確認して接続を解除できます。サーバーは PKCE（S256）を使用した OAuth 2.1 認可コードフローと、動的クライアント登録をサポートしています。
• Platform、API キー： Authorization: Bearer vk_live_...（テストデータの場合は vk_test_...）。アカウント所有者は同じ Developers ページで、それぞれ固有のスコープを持つキーを作成します。キーは環境変数に保存し、チャットに貼り付けたり、コミットしたりしないでください。

接続

Claude Code

# Docs (no key)
claude mcp add --transport http vocenya-docs https://vocenya.com/mcp/docs

# Platform with OAuth (Claude Code opens the Vocenya sign-in)
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform

# Or platform with an API key in an environment variable
claude mcp add --transport http vocenya https://vocenya.com/mcp/platform \
  --header "Authorization: Bearer $VOCENYA_API_KEY"

または、このリポジトリからプラグインをインストールします。Docs サーバーと2つのスキル（REST API と Webhook、Web サイトのライブチャットのインストール）が追加されます。

claude plugin marketplace add gadyamedia/vocenya-mcp
claude plugin install vocenya@vocenya

Claude Desktop と claude.ai

Docs サーバー：Settings > Connectors > Add custom connector で、URL https://vocenya.com/mcp/docs を指定します。認証は不要です。

Platform サーバー：URL https://vocenya.com/mcp/platform を指定してカスタムコネクターを追加し、Vocenya のオーナーアカウントでサインインします（OAuth）。

または、API キーを使用する場合は、claude_desktop_config.json で mcp-remote ブリッジを介して接続します。

{
    "mcpServers": {
        "vocenya": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://vocenya.com/mcp/platform",
                "--header",
                "Authorization:${VOCENYA_AUTH}"
            ],
            "env": {
                "VOCENYA_AUTH": "Bearer paste-your-key-here"
            }
        }
    }
}

Cursor

~/.cursor/mcp.json：

{
    "mcpServers": {
        "vocenya-docs": { "url": "https://vocenya.com/mcp/docs" },
        "vocenya": {
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${env:VOCENYA_API_KEY}" }
        }
    }
}

VS Code

.vscode/mcp.json（VS Code はキーを一度入力するよう求め、安全に保存します）：

{
    "inputs": [
        {
            "type": "promptString",
            "id": "vocenya-key",
            "description": "Vocenya API key (vk_live_... or vk_test_...)",
            "password": true
        }
    ],
    "servers": {
        "vocenya-docs": {
            "type": "http",
            "url": "https://vocenya.com/mcp/docs"
        },
        "vocenya": {
            "type": "http",
            "url": "https://vocenya.com/mcp/platform",
            "headers": { "Authorization": "Bearer ${input:vocenya-key}" }
        }
    }
}

ChatGPT

開発者モードを有効にしてから、URL https://vocenya.com/mcp/docs を指定し、認証なしでカスタムコネクターを追加します。アカウントデータを利用するには、OAuth で https://vocenya.com/mcp/platform を追加し、Vocenya のオーナーアカウントでサインインします。

Grok と Grok Bot

Grok Business および Enterprise では、https://vocenya.com/mcp/platform をカスタム MCP コネクター（「Bring your own MCP」）として追加し、OAuth でサインインするか、読み取りスコープのみを指定した API キーを使用します。plugins/vocenya-grok フォルダーには、Grok Bot 向けに、両方のサーバーと毎日のフロントデスクレビュー用スキルがまとめられています。このスキルは、通話、チャット、リードを要約し、フォローアップの下書きを作成します。承認なしに顧客へ連絡することはありません。

その他のクライアント

Streamable HTTP に対応するクライアントであれば使用できます。platform サーバーでは、OAuth でサインインするか、Authorization: Bearer <your key> を送信します。

プロンプトの例

• 「Vocenya のドキュメントを参照して、Webhook の署名を検証する方法を教えてください。Node のコードも示してください。」
• 「リードを作成するにはどのスコープが必要ですか。また、リクエストボディはどのような形式ですか？」
• 「今週、AI 受付が記録したリードを表示してください。」（platform）
• 「AI が来週の月曜日に予約した予定を教えてください。」（platform）
• 「Vocenya の料金と、各プランに含まれる AI 分数を教えてください。」（site）

公式 MCP Registry

registry/ 内のファイルは、com.vocenya 名前空間（com.vocenya/docs、com.vocenya/platform、com.vocenya/site）で公式 MCP Registryに公開されているエントリーです。

リンク

• MCP ガイド：https://vocenya.com/docs/mcp
• 開発者向けドキュメント：https://vocenya.com/docs
• API リファレンス：https://vocenya.com/docs/reference（OpenAPI：https://vocenya.com/docs/api.json）
• テストモード：https://vocenya.com/docs/test-mode
• LLM 向けドキュメント：https://vocenya.com/docs/llms.txt と https://vocenya.com/docs/llms-full.txt
• 料金：https://vocenya.com/pricing
• プライバシー：https://vocenya.com/privacy · 利用規約：https://vocenya.com/terms

プライバシー

docs サーバーと site サーバーは読み取り専用で、顧客のアカウントを参照できません。platform サーバーが参照できるのは、API キーを所有する（または OAuth 接続時にオーナーが選択した）1 つのビジネスアカウントのみであり、承認されたスコープで許可されている情報に限られます。HIPAA モードは、有料のアドオンで、署名済みの BAA が必要です。AI クライアントを接続しても、そのクライアントが BAA の対象になるわけではありません。そのため、独自の契約を結んでいる AI ツールにのみ患者データを送信してください。ポリシー全文：https://vocenya.com/privacy

サポート、セキュリティ、ライセンス

• 質問や修正の提案：issue を作成するか、[email protected] にメールしてください
• セキュリティに関する報告：SECURITY.md をご覧ください
• ライセンス：MIT は、このリポジトリの内容に適用されます。Vocenya サービス自体は、Vocenya の利用規約に基づくホスト型の商用製品です。

Copyright (c) 2026 DRAKB LLC dba GH Business Solutions.