pluggy-mcp

Pluggy API のデータプロダクト面をラップするリモート Model Context Protocol サーバーで、Cloudflare Workers 上にデプロイされています。

Cloudflare Agents（McpAgent）を Streamable HTTP トランスポートで使用して構築されています。

ツール

Pluggy のデータプロダクトにわたる25のツールを公開しています：

Payments、webhooks、Smart Transfers は対象外です。

Related MCP server: Copiloto Financeiro MCP Server

認証

MCP クライアントは、すべてのリクエストで Bearer トークンを使用して認証します：

Authorization: Bearer <base64(clientId:clientSecret)>

トークンを生成します：

printf '%s:%s' "$PLUGGY_CLIENT_ID" "$PLUGGY_CLIENT_SECRET" | base64

Worker はトークンをデコードし、POST /auth を介して短命の Pluggy API キーを発行し（TTL 2時間、期限切れの5分前に更新）、すべての Pluggy API 呼び出しで X-API-KEY として送信します。Pluggy の認証情報が MCP クライアントに届くことはありません。

開発

npm install
npm run dev   # wrangler dev on http://127.0.0.1:8787

デプロイ

npx wrangler deploy

接続

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "pluggy": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <base64(clientId:clientSecret)>" }
    }
  }
}

Claude Desktop / Windsurf

同じ形式で、設定ファイルが異なります（claude_desktop_config.json / ~/.codeium/windsurf/mcp_config.json）。

注意事項

• list_items はオプトインの Pluggy 機能です。Pluggy サポートがチームに対して有効化するまで、403 LIST_ITEMS_FEATURE_NOT_ENABLED を返します。

• list_transactions はカーソルベースの GET /v2/transactions エンドポイントを使用します。前のレスポンスの next 値から after カーソルを渡してページネーションします。

• Durable Object はセッションと発行された API キーをその存続期間中保持します。認証情報は Worker の fetch ハンドラーを介してリクエストごとに ctx.props に渡されます。