pluggy-mcp

Pluggy API 데이터 제품 표면을 래핑하는 원격 Model Context Protocol 서버로, Cloudflare Workers에 배포됩니다.

Streamable HTTP 전송을 사용하는 Cloudflare Agents(McpAgent)로 구축되었습니다.

도구

Pluggy의 데이터 제품 전반에 걸쳐 25개의 도구를 제공합니다:

결제, 웹훅, 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 키를 발급하며(2시간 TTL, 만료 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에 전달됩니다.