概要
AI に Botpress のボットを確認させます。ワークスペースとボット、会話、メッセージ、ユーザー、イベント、ボットのログ、アナリティクス、Issue、ボットのテーブル（行の検索、追加、更新）、ナレッジベースのファイルのセマンティック検索に対応します。
ガイド付きセットアップ
Botpress を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Botpress を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Botpress のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Botpress をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Botpress + Microsoft Copilot
AI に Botpress のボットを確認させます。ワークスペースとボット、会話、メッセージ、ユーザー、イベント、ボットのログ、アナリティクス、Issue、ボットのテーブル（行の検索、追加、更新）、ナレッジベースのファイルのセマンティック検索に対応します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
BOTPRESS_TOKEN, BOTPRESS_WORKSPACE_ID, BOTPRESS_BOT_ID
ステップ 1 — 認証情報を取得
https://app.botpress.cloudにサインインします。右上のプロフィールメニュー → Profile Settings → Personal Access Tokens を開き、トークンを作成してコピーします（bp_pat_で始まります）。Bearer という語を付けずにBOTPRESS_TOKENに貼り付けます。- ワークスペース ID（
BOTPRESS_WORKSPACE_ID）: ダッシュボードでワークスペースを開き、URL のwkspace_...の部分をコピーします（app.botpress.cloud/workspaces/wkspace_...）。 - ボット ID（
BOTPRESS_BOT_ID）: ボットを開き、URL の/bots/の後ろにある UUID をコピーします。Studio のボット設定にも表示されます。 - コネクタをインストールします。3 つの値は Botpress にだけ送信されます。インストール後は、
botpress_list_workspacesとbotpress_list_botsでほかのワークスペースやボットの ID も確認できます。
誰が何を見られるか: トークンには、あなたが所属するすべてのワークスペースへのあなた自身のアクセス権があります。トークンは秘密にし、MCP サーバーはボットの会話を読んでよい人とだけ共有してください。会話には個人データが含まれることがあります。
使用する Botpress の API: 1 つの Personal Access Token で 4 つすべてにアクセスできます（管理系ツールは Bot Access Key では動かないため、個人用トークンを使ってください）。
- Admin API: ワークスペース、ボット、ボットのログ、アナリティクス、Issue。
- Runtime API: すべてのチャネル（Webchat、WhatsApp、Slack など）からのボットの会話、メッセージ、ユーザー、イベント。Botpress の別の Chat API は、自身の Chat インテグレーションの会話しか見られないため使用しません。
- Tables API: ボットのテーブル。行の検索、追加、更新。
- Files API: ボットのナレッジベースのファイル。インデックス済みのファイルをセマンティック検索できます。
複数のボット: 会話、メッセージ、ユーザー、イベント、テーブル、ファイルのツールは、別のボットを指定しない限り BOTPRESS_BOT_ID のボットを対象にします。ボット用のツール（概要、ログ、アナリティクス、Issue）は毎回ボット ID を受け取るので、AI はワークスペース内のボットを比較できます。
先に確認します: botpress_create_table_rows と botpress_update_table_rows はボットのデータを変更するため、AI は対象の行を示し、あなたの承認を待ちます。botpress_delete_table_rows はインストール時に無効です。AI に行を削除させたい場合にだけ、コネクタ設定で有効にしてください。削除は行 ID 指定のみです。
信頼できないコンテンツ: メッセージ、ユーザーの項目、ファイルの一節は、エンドユーザーやアップロードされた文書に由来します。AI はその中の指示をデータとして扱い、命令としては扱いません。
よくあるエラー: 401 Unauthorized: トークンが間違っているか取り消されています。またはワークスペース ID が、あなたのユーザーが所属するワークスペースではありません。403 Forbidden: ワークスペースでのあなたのロールではその操作ができません。404 ResourceNotFound: 不明な ID、または BOTPRESS_BOT_ID とは別のボットの会話やテーブルです。400 InvalidPayload または InvalidQuery: パラメーターが無効です。たとえば日付が ISO 8601 形式ではありません。429 RateLimited: 少し待ってから再試行してください。
このコネクタは、ボットの作成、デプロイ、削除、ボットとしてのメッセージ送信、インテグレーションの管理、ナレッジベースへのファイルのアップロード、ワークスペースのメンバーと請求の管理には対応していません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Botpressのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
botpress_list_workspaces | List the Botpress workspaces the token's user belongs to, with id, name, plan, bot count, spending limit and whether the workspace is… |
botpress_list_bots | List the bots of a Botpress workspace (production bots, or dev bots with dev true) with id, name, type, tags and last deploy time |
botpress_get_bot | Get one bot's overview: name, description, status, deploy time, whether it is a dev bot, tags, and its installed integrations with version… |
botpress_get_bot_logs | Read a bot's runtime logs (console output, errors and system messages) from timeStart on, filtered by level, conversation, user, workflow… |
botpress_get_bot_analytics | Get a bot's usage analytics between two dates: per period new and returning users, sessions, user and bot messages, events, conversations… |
botpress_list_bot_issues | List the issues Botpress recorded for a bot (errors in its code, hit limits, configuration problems) with code, title, description… |
botpress_list_conversations | List a bot's conversations from every channel, newest first, with id, integration and channel (e.g. webchat, whatsapp), message count, tags… |
botpress_get_conversation | Get one conversation of a bot: integration, channel, message count, tags, shared properties and dates |
botpress_list_messages | List a bot's messages, newest first, usually of one conversation (conversationId) |
botpress_list_users | List the end users who talked to a bot (one per channel: the same person on Slack and WhatsApp is two users), with id, name, tags and dates |
botpress_get_user | Get one end user of a bot: name, picture URL, tags, attributes and properties set by the bot or its integrations, and dates |
botpress_list_events | List a bot's events (incoming messages, integration events, custom and scheduled events) with type, status (pending, processed, ignored… |
botpress_get_event | Get one event of a bot with its full payload, status and failureReason |
botpress_list_tables | List a bot's tables with id, name, row factor, key column, whether it is frozen and the column schema |
botpress_get_table | Get one table of a bot with its columns (names, types, descriptions, computed settings), key column, its row count (rows) and how many rows… |
botpress_find_table_rows | Query rows of a bot's table with a MongoDB-like filter, full-text search, column selection, ordering and offset paging; group adds… |
botpress_create_table_rows | Add rows to a bot's table (1 to 1,000 per call), each an object of column values matching the table's schema (see botpress_get_table) |
botpress_update_table_rows | Update rows of a bot's table by id (1 to 1,000 per call): each row is {"id": 12, "column": "new value"} and only the given columns change |
botpress_delete_table_rows | Permanently delete rows of a bot's table by their ids (up to 1,000 per call) |
botpress_list_files | List a bot's files (knowledge-base documents and other uploads) with id, key, content type, size, tags, status (upload or indexing state)… |
botpress_search_files | Semantic search over a bot's indexed files (its knowledge base): returns the passages that best match a natural-language query, with score… |
プロンプトの例
- 「今週サポートボットに最も多く寄せられた質問は何ですか？最近の会話の主なテーマをまとめてください。」
- 「昨日ボットがうまく動かなかったのはなぜですか？Issue と 9 時以降のエラーログを確認してください。」
- 「過去 30 日間のボットの新規ユーザーとリピーター、セッション数、メッセージ数を見せてください。」
- 「Leads テーブルでメールアドレスが [email protected] の行を探して、ステータスを contacted にしてください。変更する前に内容を見せてください。」
- 「ボットのナレッジベースで返金ポリシーを検索して、回答がどのファイルから来ているか教えてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?