Podio MCPをMicrosoft Copilotに接続

💡 インストール不要。cloud.anythingmcp.com をそのまま使えます。 サインインし、Connectors → Podio をクリックして認証情報を貼り付け、MCP APIキーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

Podio + Microsoft Copilot

Podioの1つのアプリを読み取ります。フィールド定義、フィルタ済みのアイテムのページ、単一のアイテムを取得できます。Podioのアプリ認証でサインインします。読み取り専用です。

前提条件

コネクタに組み込まれているセットアップ手順の全文を参照してください(アプリ内ストアでコネクタを選択すると表示されます)。このコネクタに必要な環境変数は次のとおりです。

PODIO_APP_ID, PODIO_APP_TOKEN, PODIO_CLIENT_ID, PODIO_CLIENT_SECRET

ステップ1 — 認証情報を取得する

セットアップには約5分かかります。Podio APIキー(クライアントIDとシークレット)に加えて、AIに読み取らせる1つのPodioアプリのApp IDとApp tokenが必要です。

1. https://podio.com/settings/api を開き、APIキーを生成します。クライアントIDを PODIO_CLIENT_ID に、クライアントシークレットを PODIO_CLIENT_SECRET にコピーします。シークレットは一度しか表示されません。
2. Podioのアプリを開き、レンチメニューから Developer を開きます。App ID を PODIO_APP_ID に、App token を PODIO_APP_TOKEN にコピーします。
3. コネクタをインストールして podio_get_app を実行します。サインインが行われ、アプリ名とすべてのフィールドが返されます。

対象は1つのアプリのみ: 4つの値により、コネクタはそのアプリとしてサインインします(Podioのアプリ認証)。アクセストークンの有効期間は8時間で、期限が切れるとコネクタが自動的に再サインインします。ワークスペース内の他のアプリにはアクセスできません。アプリ外への呼び出しは403を返します。PodioのAPIは公開されているため、AnythingMCP Cloudでもセルフホスト環境でも動作します。

読み取れる内容: podio_get_app は、すべてのフィールドについて field_id、external_id、タイプ、ラベル、必須フラグ、設定(カテゴリオプションのIDなど)を返します。podio_filter_items はフィールド値を含むアイテムのページを一覧表示します。podio_get_item は、その一覧に含まれる数値の item_id(app_item_id ではありません)を指定して1件のアイテムを開きます。アイテムを読み取っても既読にはならないため、Podioの通知は消えません。

フィルタとページ: AIはフィールドの external_id、または title、created_on、created_by、last_edit_on、tags、item_id、app_item_id、external_id でフィルタします。カテゴリの値はオプションIDです。数値、金額、日付は from/to の範囲を指定し、日付は -7d や +1w のような相対指定も可能です。テキストフィールドはフィルタできません(title によるアイテムタイトルのみ例外です)。1ページのデフォルトは20件で、最大100件です。

制限: Podioは、APIキーごとに1時間あたりの呼び出し回数をカウントします。podio_filter_items は250回、その他の読み取りは1,000回です。上限を超えるとPodioはHTTP 420(429ではありません)を返し、AIは待機してから再試行します。

よくあるエラー: サインイン時の400は、クライアントID、クライアントシークレット、App ID、App tokenの組み合わせが正しくないことを意味します。401はPodioがアクセストークンを拒否したことを意味します。コネクタを保存し直して再サインインさせ、4つの値を再確認してください。403は、このトークンで読み取れる1つのアプリの範囲外を呼び出したことを意味します。404は、そのIDのアプリまたはアイテムが存在しないことを意味します。

このコネクタは、アイテムの作成や編集、コメントやファイルの読み取り、他のアプリへのアクセス、Podioユーザーとしてのサインインは行いません。

ステップ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 はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Podio のツールが必要になる依頼をしてみましょう。
6. 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 は使えません。

利用可能なツール

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" と入力すると新しいバージョンになります。

次のステップ

• コネクタのランディングページ
• Claudeに接続する
• ChatGPTに接続する