ChatGPT や Claude を Chatbotta に接続する

Chatbotta の MCP サーバーを自分の ChatGPT や Claude に追加してサインインで認証すると、新しいプロジェクトの設定を AI に手伝ってもらえます。事業の情報をナレッジに変換し、ボットのペルソナを調整し、お客様になりきってボットをテストし、残っている設定ステップを確認できます。

MCP サーバーの URL

ChatGPT、Claude、またはリモート MCP サーバーに対応した AI アプリに、次の URL を追加します。

https://api.chatbotta.com/mcp

接続方法

Chatbotta プラグインをインストールする

Web 版またはデスクトップ版の Claude を開き、サイドバーの Customize → Plugins に進んで Add marketplace を選び、 Chatbotta/agent-plugins と入力して、一覧から Chatbotta をインストールします。
サインインして認証する

Claude が Chatbotta の認証ページを開きます。Chatbotta のアカウントでサインインし、権限を確認して「Allow」（許可）を選びます。
使い始める

新しい会話を始め、Claude に Chatbotta を使うよう頼みます。

ターミナルで次のコマンドを実行し、表示に従ってサインインします。

claude mcp add --transport http chatbotta https://api.chatbotta.com/mcp

Chatbotta のプラグインマーケットプレイスを追加する

ターミナルで次のコマンドを実行します。
ターミナルウィンドウ
```
codex plugin marketplace add Chatbotta/agent-plugins
```
プラグインをインストールする

Codex を再起動し、Plugins Directory で Chatbotta のマーケットプレイスを選んでインストールします。
サインインして認証する

表示に従って Chatbotta のアカウントにサインインし、認証ページで「Allow」を選びます。

Chatbotta のアカウントをまだお持ちでない場合

そのまま AI アプリから接続を始めてください。認証ページで登録し、メールアドレスを確認して最初のプロジェクトを作成すると、認証ページに戻って接続を完了できます。

認証ページに表示される内容

アプリの名前と提供元： 自社ドメインで身元を証明できるアプリには「Verified by (ドメイン)」のバッジが表示されます。自己登録のアプリには警告と、アクセス先のサイトが表示されます（自分のパソコン上のプログラムは localhost と表示されます）。接続は信頼できる AI アプリからのみ始めてください。
認証に使うアカウント： 正しいアカウントでない場合は「Switch account」を選びます。
許可される操作： 読み取り権限は「See your projects, knowledge, bot persona and setup progress」（プロジェクト、ナレッジ、ボットのペルソナ、設定の進み具合の閲覧）、読み書き権限は「Add and edit knowledge and the bot persona, and ask your bot questions in project testing」（ナレッジとボットのペルソナの追加・編集、プロジェクトのテストでのボットへの質問）です。
アクセスできるプロジェクト： 現在所属している、または今後参加するすべてのプロジェクトで、それぞれのロールの範囲でアクセスできます。

AI に頼めること

最初のバージョンは、新しいプロジェクトの設定に重点を置いています。「Web サイトの料金表を読み込んで、Chatbotta にナレッジとして取り込んで」「ボットのペルソナをもっと親しみやすくして」「お客様としてよくある質問をいくつかして、ボットの回答を見せて」のように、普段の言葉で頼むだけです。AI は次のツールを使います。

情報の確認（読み取り権限で可）

list_workspaces：アクセスできるプロジェクトと、それぞれのロールを一覧表示します
get_setup_status：設定の進み具合を表示します。スタートガイドのチェックリスト、ナレッジの件数（新規プロジェクトに最初から入っているサンプルを含む）、ボットのペルソナの設定有無、AI 自動返信、LINE・Facebook・Instagram・Web チャットの各チャネルの接続状況と、アプリ内の該当ページへのリンクです
list_knowledge：プロジェクトの有効なナレッジを一覧表示します
search_knowledge：お客様が質問したときにボットが使うのと同じセマンティック検索を実行し、質問でどのナレッジが見つかるかを確認します
get_custom_prompt：プロジェクトのボットのペルソナを読み取ります

変更（読み書き権限が必要）

review_knowledge_import：新しいナレッジ（一度に最大 10 件）を既存のナレッジと比較して重複や矛盾を見つけます。アプリでナレッジを取り込むときと同じ確認処理を使います
apply_knowledge_import：確認済みのナレッジを保存し、すぐにお客様への回答に反映します。判断していない項目には推奨のアクションが使われます。置き換えた項目はゴミ箱に移り、アプリで復元できます
archive_knowledge：新規プロジェクトに最初から入っているサンプルなど、ナレッジをゴミ箱に移します（一度に最大 10 件）
update_custom_prompt：ボットのペルソナを書き換えます。以前の内容は 30 日間バージョン履歴に残ります
preview_bot_reply：お客様としてボットに質問します。返信には実際のチャットと同じ AI、ナレッジ、ボットのペルソナ、ツールに加え、未公開のフローの変更も使われます
deploy_bot：現在の下書きフローを公開し、バージョン履歴にバージョンを追加して、各チャネルのメニューを同期します（プロジェクトでの公開権限が必要です）

セキュリティと制限

お客様の会話にはアクセスしません： お客様とのチャットを読んだり返信したりするツールは、意図的に用意していません。お客様のメッセージには AI に向けた指示や個人情報が含まれる可能性があるため、第三者の AI には渡しません。
あなたの権限を超えることはありません： 呼び出しのたびに、プロジェクトでのあなたのロールを確認し直します。あなたがプロジェクトでできないことは、AI にもできません。
プランが終了したプロジェクトは読み取り専用： プランが終了したプロジェクトは閲覧できますが、変更はできません。
AI の利用枠： ナレッジの確認とボットのテストには AI を使い、プロジェクトの 1 日あたりの AI 利用枠を Copilot と共有します。利用枠は台湾時間の午前 0 時にリセットされます。また、接続ごとに 1 日あたりの操作回数の上限があります。
チャネル： LINE・Facebook・Instagram・Web チャットの接続は、引き続き Chatbotta アプリの「Channels」（チャネル）で行います。AI が該当ページへのリンクを案内します。

接続の確認と取り消し

Chatbotta で「Account」ウィンドウを開き、「Connect an AI assistant」を選びます。「Authorized AI assistants」に、接続しているすべての AI アプリが表示されます。

「Revoke」（取り消し）を選ぶと、そのアプリは Chatbotta のプロジェクトにただちにアクセスできなくなります。後から AI アプリで再接続することもできます。プロジェクト、ナレッジ、会話には影響ありません。

よくある質問

「Apps」の外部ツールとの違いは何ですか？

方向が逆です。このページの機能は、あなた自身の ChatGPT や Claude が Chatbotta に接続して設定を手伝うものです。外部ツールは、Chatbotta のボットがお客様とのチャット中にあなたのシステムを呼び出す（注文や在庫の照会など）ものです。

認証ページに、リクエストの有効期限切れまたは使用済みと表示される

AI アプリに戻って、もう一度接続してください。認証リクエストの有効期間は 60 分で、登録してプロジェクトを作成するには十分な時間です。

プロジェクトのデータは誰に渡りますか？

AI がツールを通じて読み取ったプロジェクトの内容（ナレッジ、ボットのペルソナなど）は、あなたが使っている AI サービスに送られ、そのサービスでのあなたのアカウントと設定に従って扱われます。共有を止めるには、「Authorized AI assistants」でそのアプリを取り消してください。

開発者向け情報

MCP エンドポイント： https://api.chatbotta.com/mcp（Streamable HTTP、ステートレス）
認可サーバーメタデータ（RFC 8414）： https://api.chatbotta.com/.well-known/oauth-authorization-server
保護リソースメタデータ（RFC 9728）： https://api.chatbotta.com/.well-known/oauth-protected-resource/mcp
スコープ： chatbotta.read、chatbotta.write（write は read を含みます。指定がない場合は両方が要求されます）

認可フロー：

クライアント登録：Client ID Metadata Documents を推奨します（client_id は https の URL）。Dynamic Client Registration（/oauth/register）にも対応しています。
PKCE（S256）は必須で、resource パラメーターには MCP エンドポイントの URL を指定する必要があります（RFC 8707）。認可レスポンスには iss パラメーターが含まれます（RFC 9207）。
ループバックのリダイレクト URL には任意のポートを使えます。
アクセストークンの有効期間は 1 時間、リフレッシュトークンは 90 日間で、使用するたびにローテーションされます。
トークンの取り消し：https://api.chatbotta.com/oauth/revoke。