RinghumをClaudeなどのAIツールに接続する(MCP)

RinghumにはMCPサーバーがあります。MCP(Model Context Protocol)は、AIアプリが外部ツールを利用するための標準的な仕組みです。ClaudeやChatGPTのようなAIアプリにRinghumを接続すると、ワークスペースについて自然な言葉で質問できるようになります。たとえば「昨日の不在着信を要約して」「今週折り返しを依頼した発信者は?」「新しい営業時間をFAQに追加して」といった具合です。AIアプリは、Ringhum APIと同じルールと権限のもとで動作します。

必要なもの

• サーバーURL: https://ringhum.com/mcp。開発者ページのMCPサーバーカードにも表示されており、コピーボタンがあります。
• リモートMCPサーバーに対応したAIアプリ(Claude、ChatGPT、Claude Code、Cursor、Windsurf、VS Codeなど)。
• ワークスペースでのオーナーまたは管理者のロール。アプリの接続やAPIキーの作成ができるのはオーナーと管理者のみです。

接続方法は2通りあります。サインインはもっとも簡単で、Claudeや ChatGPTのようなチャットアプリに向いています。APIキーは、URLとヘッダーを設定する開発者向けツールに向いています。

参照のみか、参照と変更か

AIアプリにどこまでの操作を許可するかを選べます。

参照のみのアクセス権の場合、変更を行うツール自体がアプリに提供されません。

重要: 変更権限を与えると、AIアプリは実際のメッセージ送信や発信を顧客に対して行えるようになります。Ringhumはこれらのツールをワークスペース外への操作として、また削除操作を破壊的操作としてマークしているため、ほとんどのAIアプリは実行前に確認を求めます。承認する前に、アプリが何を行おうとしているかを確認してください。

サインインでClaudeを接続する

1. Claude(Web、デスクトップ、モバイルいずれか)で設定 → コネクタを開き、カスタムコネクタを追加を選びます。
2. URLとしてhttps://ringhum.com/mcpを貼り付けて保存します。
3. 接続をクリックします。Ringhumのページが開きます。求められたらサインインしてください。
4. 接続ページで、アプリが使用するワークスペースを選びます。
5. 許可する操作で、参照のみか参照と変更かを選びます。
6. 許可をクリックします。Claudeに戻ります。

パスワードがアプリに見られることはありません。Claude内の正確なメニュー名は変更されることがあるため、設定内で「コネクタ」または「連携」といった項目を探してください。

ChatGPT: 設定 → アプリとコネクタでカスタムコネクタ(MCPサーバー)としてURLを追加し、接続をクリックして手順3〜6に従ってください。

Claude Code: 以下のコマンドを実行した後、/mcpを実行してAuthenticateを選んでください。

claude mcp add --transport http ringhum https://ringhum.com/mcp

アクセスを許可した後、使い続けている限り接続は自動的に更新されます。90日間使用しない場合は、再度接続する必要があります。

APIキーで接続する

リクエストヘッダーを設定できるツールや、サインインしたくない場合に使用します。

1. 開発者でAPIキーを作成します。参照のみの接続にはreadのみ、変更も許可する場合はreadとwriteの両方にチェックを入れます。詳しくはAPIキーとスコープをご覧ください。
2. Authorizationヘッダーにキーを設定して、サーバーをアプリに追加します。

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor(~/.cursor/mcp.json)、Windsurf、Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code(.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

ローカルサーバーしか実行できないアプリの場合は、npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…"で接続できます。

ツールがカバーする範囲

Ringhum APIのすべての操作がツールとして提供されます。アカウントと利用状況、アシスタント、電話番号、通話と書き起こし、連絡先、予約と空き状況、注文と商品、宿泊予約、受信トレイ、テキストとWhatsAppメッセージ、キャンペーン、Webhook、会社プロフィール、サービス、FAQ、ナレッジベース、未回答の質問、支払いリンク、レビュー依頼、売上、迷惑通話対策が含まれます。唯一の例外は通話録音で、ツールとしては提供されていません。

各ツールは対応するAPIリクエストを実行するため、同じプランの上限、バリデーション、レート制限が適用されます。ツールの呼び出しも、APIの1分あたり120リクエストの制限にカウントされます。ツールの完全な一覧は、/docsのAPIリファレンスのMCPセクションにあります。

接続済みアプリの確認と解除

サインインで接続したアプリは、開発者の接続済みAIアプリに、接続した人、そのアクセス権(参照のみまたは参照と変更)、最終利用日時とともに一覧表示されます。

アプリを削除するには、接続を解除をクリックして確定します。アクセス権はすぐに失われ、再度承認が必要になります。アプリのアクセス権を変更するには、一度接続を解除し、別の選択で再接続してください。

APIキーで作成した接続の場合は、APIキーでそのキーを取り消してください。

トラブルシューティング

「アプリを接続できるのは、ワークスペースのオーナーと管理者のみです。」 ワークスペースのオーナーにアプリの接続を依頼するか、自分を管理者にしてもらってください。詳しくはチームを招待するをご覧ください。

「サインインリクエストの有効期限が切れました。AIアプリから接続をやり直してください。」 承認ページを開いたまま時間が経ちすぎました。AIアプリ側から最初からやり直してください。

アプリが「認可されていません」と表示する、または再度サインインを求められる。 アプリの接続が解除された、キーが取り消された、またはあなたがそのワークスペースのメンバーでなくなった可能性があります。再度接続してください。

アプリが変更を行えない。 参照のみのアクセス権で接続されているか、APIキーにwriteスコープがありません。

アプリが誤ったワークスペースを参照している。 who_am_iを呼び出して確認するようアプリに依頼してください。各接続は1つのワークスペースのみを使用します。別のワークスペースを選ぶには、一度接続を解除して再接続してください。