SimplyBoost MCP

公式

SimplyBoost AIのサポートエージェントに質問し、チームに引き継がれた会話に回答し、見込み客にフォローアップし、ナレッジを更新できます。

SimplyBoost MCPで何ができますか？

チャットボットを探す — トークンで利用できるチャットボットを一覧表示し、IDを指定してチャットボットの詳細を取得します。
訪問者としてメッセージを送信する — 訪問者としてチャットボットに質問し、既存の会話を続けるには threadId を渡します。
会話を確認する — すべてのチャネルの会話を一覧表示し、メッセージを読み、個別の会話を取得します。
担当者として会話を処理する — 会話を引き継いで返信し、チャットボットに戻すほか、解決済みにしたり再開したりします。
リードを管理する — 取得したリードを一覧表示して内容を確認し、詳細を更新するかコンバージョン済みにし、リードを削除します。
ナレッジソースを管理する — チャットボットが把握している内容を一覧表示し、テキストやウェブサイトを追加し、ソースを編集または更新して、削除します。

ホスト型 MCP サーバー

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

概要

MCP サーバーは https://get-api.simplyboost.io/api/v1/mcp にあります。Streamable HTTP トランスポートを使用し、REST API (Authorization: Bearer sb_live_…) と同じ API トークン、同じプラン（Growth、Pro、Enterprise）、同じ権限、同じ制限を使用します。各ツールは対応する REST エンドポイントと同じ処理を行い、同じスコープを必要とします。アシスタントが使用できないツールは、エラーではなく明確な拒否として表示されます。

ステートレスです。各呼び出しは1つのリクエストと1つの応答で完結し、維持するセッションはないため、どのマシンからでも接続できます。サーバーが独自にストリームを開始することはありません。

クライアントを接続する

接続方法は2つあります。サインイン（OAuth）：サーバーのアドレスを追加し、クライアントから求められたら、チームオーナーとして SimplyBoost のタブで承認し、チーム、権限、チャットボットを選択します。claude.ai と ChatGPT のコネクタ、Cursor、Codex、Claude Code はこの方法で接続でき、貼り付けるものはありません。トークン：手動で設定するクライアントや独自のスクリプトでは、Settings → API でアシスタントに必要な権限だけを付与したトークンを作成し、ヘッダーとして送信します。

Claude Code（求められたらサインイン）

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor、Windsurf、VS Code、その他の mcp.json を使うクライアント（求められたらサインイン）

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

同じ設定で、サインインの代わりにトークンを使用

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

サインインによる接続は90日間有効です。オーナーがチェックを付けた権限のみが付与されます（削除はチェックを付けない限り無効です）。接続は Settings → API → Connected apps に表示され、オーナーはいつでも切断できます。トークンの作成と同様、接続を承認できるのはチームオーナーだけです。承認画面に表示されるアプリ名は、アプリが自ら申告したものです。SimplyBoost はその名前を検証しません。

クライアント設定に保存したトークンは、アカウントのパスワードと同じです。自分のコンピューターに保管し、有効期限を設定し、設定ファイルを共有した場合はローテーションしてください。サインインを使えばこの問題を避けられます。ファイルに秘密情報が書き込まれることはありません。

クライアント開発者向け：サーバーは MCP 認可仕様に準拠しています。認証情報のないリクエストには 401 と WWW-Authenticate ヘッダーで応答し、保護されたリソースのメタデータ (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp) を示します。このメタデータには認可サーバー (https://get-api.simplyboost.io/.well-known/oauth-authorization-server) が記載されています。クライアントは自身を登録し（Dynamic Client Registration）、PKCE を使用した認可コードフロー（S256 のみ）を使い、リソースを指定できます。また、ローテーションされるリフレッシュトークンを取得します。アクセストークンの有効期間は1時間で、MCP エンドポイントでのみ使用できます。REST エンドポイントでは API トークンを使用します。

ツール

引数と結果には REST API と同じ名前 (chatbotId、threadId、camelCase フィールド) が使われるため、エンドポイントのページは両方について説明しています。まず list_chatbots を使ってチャットボットの ID を確認してください。

ツール	必要な権限	内容
`get_account`	なし	アカウント、プラン、トークン自体の権限。
`get_usage`	`account:read`	今回の請求期間に使用したメッセージ数。
`list_chatbots`、`get_chatbot`	`chatbots:read`	トークンが使用できるチャットボット。
`send_message`	`conversations:write`	訪問者と同じようにチャットボットに質問します。プランのメッセージ数に加算されます。続けるには `threadId` を渡します。
`list_conversations`、`get_conversation`、`list_messages`	`conversations:read`	すべてのチャネルの会話とそのメッセージ。
`take_over_conversation`、`reply_to_conversation`、`hand_back_to_chatbot`、`resolve_conversation`	`conversations:write`	担当者として会話を処理します。引き受け、返信、引き継ぎ、解決、再開ができます。
`list_leads`、`get_lead`	`leads:read`	チャットボットが取得したリード。
`update_lead`	`leads:write`	リードの詳細を変更するか、コンバージョン済みとしてマークします。
`delete_lead`	`leads:delete`	リードを削除します。
`list_knowledge_sources`、`get_knowledge_source`	`knowledge:read`	各ソースのステータスとテキストを含む、チャットボットの知識。
`add_text_knowledge`、`add_website_knowledge`、`update_knowledge_source`、`refresh_knowledge_source`	`knowledge:write`	チャットボットにテキストやウェブサイトを学習させ、ソースを編集し、ウェブサイトを再読み込みします。
`delete_knowledge_source`	`knowledge:delete`	ソースを削除します。

ファイルのアップロードと Webhook はツールとして提供されていません。これらには REST エンドポイントを使用してください。削除ツールには破壊的操作のマークが付いており、サーバーの指示により、アシスタントは事前にユーザーへ確認します。

エラーと制限

権限不足、トークンから見えないチャットボット、無効な引数、プランの上限などによりツール呼び出しが拒否されると、REST API と同じ code とメッセージを含む、エラーとしてマークされたツール結果が返されます。そのため、アシスタントは変更が必要な内容を伝えられます。トークンがない、または無効な場合は 401、API を利用できないプランまたは期限切れのサブスクリプションの場合は 403、トークンごとのレート制限に達した場合は 429 が返されます。いずれも REST API と同じです。

JSON-RPC 2.0 ではないメッセージには、JSON-RPC エラーが返されます。セッションもサーバーストリームもないため、エンドポイントへの GET と DELETE は 405 を返します。