Pipefy MCPをMicrosoft Copilotに接続

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

Pipefy + Microsoft Copilot

Pipefyワークマネジメントプラットフォーム:GraphQL API経由で組織、パイプ(ワークフロー)、カード、フェーズを扱えます。AIアシスタントが参照できるパイプの一覧表示、フェーズ間を移動するカードの追跡、カードのフィールド値の読み取りができます。

前提条件

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

PIPEFY_API_TOKEN

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

セットアップには数分かかります。Pipefyアカウントと APIトークンが必要です。

1. https://app.pipefy.com/tokens を開き、Generate new token をクリックして、説明を入力して保存します。そこに表示される長い方のトークンを使用してください。本番環境では、代わりに Service Account トークンを使用することをPipefyは推奨しています(Pipefy開発者ドキュメントの Authentication ページを参照してください)。
2. トークンを PIPEFY_API_TOKEN に貼り付けます。コネクターは、すべての呼び出しでこれをベアラートークンとして送信します。
3. コネクターをインストールし、pipefy_list_organizations を実行します。このトークンで参照できる組織が一覧表示され、トークンが機能していることの確認にもなります。

読み取れる内容:あなたの組織、組織に属するパイプ(ワークフロー)、そして1つのパイプについてカード数、フェーズ、開始フォームのフィールド、ラベルを読み取れます。パイプのカードをタイトル、完了フラグ、更新時刻、現在のフェーズ、担当者とともに一覧表示し、1枚のカードをすべてのフィールド値とともに開き、1つのフェーズをカード数とフィールドとともに表示します。一般的な流れは pipefy_list_organizations、pipefy_list_pipes、pipefy_get_pipe(フェーズIDを調べるため)、pipefy_list_cards、pipefy_get_card です。

ID:PipefyのIDはすべて数値です。パイプIDはパイプのURLに含まれる数字で、たとえば https://app.pipefy.com/pipes/301234567 では 301234567 です。カード、フェーズ、組織のIDも同様です。

制限:pipefy_list_cards は、デフォルトで1ページあたり25件、最大50件のカードを返します。50件はPipefyが1回のリクエストで返す上限です。pageInfo.hasNextPage が true の場合、AIは pageInfo.endCursor を after として渡し、次のページを取得します。また、Pipefyにはプランに応じた月間のAPI呼び出し上限があり、ツールの呼び出し1回がAPI呼び出し1回に相当します。

このコネクターは読み取り専用です。カードの作成、移動、更新はできず、カードの検索もできません(代わりにページ送りで取得します)。

ステップ 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 ウィンドウで試します。Pipefy のツールが必要になる依頼をしてみましょう。
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に接続する