Servidor MCP

Conecte qualquer agente de IA — Claude, ChatGPT/Codex, Cursor, VS Code, Windsurf, Gemini — à documentação ao vivo da Pluggy, referência da API, changelog, receitas e perguntas e respostas curadas através do servidor MCP hospedado, sem autenticação.

A Model Context Protocol (MCP) server da Pluggy permite que qualquer agente de IA leia a documentação, guias, referência da API, changelog, receitas e perguntas e respostas de suporte curadas da Pluggy diretamente em tempo de execução. Em vez de adivinhar a partir de dados de treinamento desatualizados, seu agente responde a perguntas e escreve código de integração baseado na documentação live — com citações.

O servidor está hospedado em:

https://docs.pluggy.dev/api/mcp

É um servidor HTTP remoto: sem instalação, sem chave de API, sem login. Aponte qualquer cliente compatível com MCP para essa URL e funcionará.

Habilidades vs. MCP

O servidor MCP dá a um agente acesso ao vivo à documentação da Pluggy em tempo de execução. Habilidades do Agente dão ao agente o conhecimento — os padrões e melhores práticas — para construir com a Pluggy. Eles funcionam de forma independente e, ainda melhor, juntos.

O que você pode fazer com isso#

Uma vez conectado, peça ao seu agente para construir com a Pluggy e ele puxará a resposta exata e atual em vez de alucinar:

  • "Como eu crio um connect token e abro o Connect Widget?" → passos fundamentados nos guias live.
  • "Mostre-me os detalhes do endpoint createItem." → método, caminho, parâmetros e esquemas diretamente da especificação OpenAPI.
  • "O que mudou na última versão para webhooks?" → a entrada real do changelog, não uma suposição.
  • "Por que meu item está preso em WAITING_USER_INPUT?" → a pergunta e resposta de suporte curada e verificada por humanos que respondeu isso antes.
  • "Escreva o código para listar as transações de um usuário com paginação." → código de integração que corresponde à API atual.

Como ele lê o mesmo conteúdo publicado neste site, as respostas permanecem corretas à medida que a documentação evolui — você nunca precisa reensinar seu agente.

Ferramentas disponíveis#

FerramentaO que faz
queryFaça uma pergunta em linguagem natural e obtenha uma resposta gerada com citações, combinando documentação, changelog, receitas e referência da API
search_docsPesquise os guias de documentação (conceitos, quickstart, integração) com trechos classificados por relevância
search_qaPesquise as perguntas e respostas de suporte curadas e verificadas por humanos — a fonte de maior confiança para perguntas do tipo "como eu / por que X acontece"
search_changelogPesquise o changelog — notas de lançamento, mudanças significativas, notas de migração
search_recipesPesquise as receitas — padrões de integração, exemplos de código
get_guideRecupere o conteúdo completo de um único guia de documentação pelo slug e localidade
list_guidesListe todos os guias de documentação (slug, título, descrição, categoria) para uma localidade
get_api_endpointObtenha detalhes completos de um endpoint da API pelo operationId — método, caminho, parâmetros, corpo da requisição, respostas
list_endpointsListe todos os endpoints da API da Pluggy a partir da especificação OpenAPI, opcionalmente filtrados por tag

Conecte-o à sua ferramenta#

Escolha seu agente abaixo. Em todos os lugares que você vê, a URL do servidor é a mesma: https://docs.pluggy.dev/api/mcp.

Claude Code#

claude mcp add --transport http pluggy-docs https://docs.pluggy.dev/api/mcp

Adicione -s user para torná-lo disponível em todos os projetos: claude mcp add -s user --transport http pluggy-docs https://docs.pluggy.dev/api/mcp.

Claude Desktop#

Configurações → Conectores → Adicionar conector personalizado, nomeie como Pluggy Docs e cole https://docs.pluggy.dev/api/mcp. Ou edite claude_desktop_config.json:

{
  "mcpServers": {
    "pluggy-docs": {
      "type": "http",
      "url": "https://docs.pluggy.dev/api/mcp"
    }
  }
}

ChatGPT (OpenAI)#

Em Configurações → Conectores → Avançado → Modo desenvolvedor, adicione um conector com a URL https://docs.pluggy.dev/api/mcp. (Conectores MCP remotos personalizados estão disponíveis no ChatGPT Plus/Pro/Business/Enterprise.) Em um chat, ative o conector Pluggy Docs e pergunte.

OpenAI Codex CLI#

Adicione a ~/.codex/config.toml:

[mcp_servers.pluggy-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://docs.pluggy.dev/api/mcp"]

Codex se comunica com servidores MCP locais (stdio), então mcp-remote faz a ponte para o servidor HTTP hospedado.

Cursor#

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

{
  "mcpServers": {
    "pluggy-docs": {
      "url": "https://docs.pluggy.dev/api/mcp"
    }
  }
}

VS Code (modo agente do GitHub Copilot)#

Um comando:

code --add-mcp '{"name":"pluggy-docs","type":"http","url":"https://docs.pluggy.dev/api/mcp"}'

Ou crie .vscode/mcp.json em seu espaço de trabalho:

{
  "servers": {
    "pluggy-docs": {
      "type": "http",
      "url": "https://docs.pluggy.dev/api/mcp"
    }
  }
}

Windsurf#

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pluggy-docs": {
      "serverUrl": "https://docs.pluggy.dev/api/mcp"
    }
  }
}

Gemini CLI#

Adicione a ~/.gemini/settings.json:

{
  "mcpServers": {
    "pluggy-docs": {
      "httpUrl": "https://docs.pluggy.dev/api/mcp"
    }
  }
}

Zed#

Adicione ao seu settings.json do Zed:

{
  "context_servers": {
    "pluggy-docs": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://docs.pluggy.dev/api/mcp"]
      }
    }
  }
}

Qualquer outro cliente MCP#

Se seu cliente suportar apenas servidores locais (stdio), faça a ponte para o hospedado com mcp-remote:

npx -y mcp-remote https://docs.pluggy.dev/api/mcp

Clientes que suportam servidores remotos Streamable HTTP podem usar a URL diretamente.

Teste sua configuração#

Inicie um novo chat com seu agente e tente:

Usando a documentação MCP da Pluggy, como eu crio um connect token e abro o Connect Widget?

ou

Liste os endpoints da API da Pluggy para Items e mostre-me os detalhes de createItem.

O agente deve chamar as ferramentas MCP e responder com citações da documentação live. Se nada acontecer, reinicie o cliente após adicionar o servidor e confirme se a URL é exatamente https://docs.pluggy.dev/api/mcp.

O que ele expõe#

O servidor cobre tudo publicado neste site:

  • Guias de documentação — conceitos, quickstart e guias de integração (EN, PT, ES)
  • Referência da API — cada endpoint da especificação OpenAPI, com parâmetros e esquemas
  • Changelog — notas de lançamento, mudanças significativas e notas de migração
  • Receitas — padrões de integração passo a passo e exemplos de código
  • Perguntas e respostas curadas — perguntas reais de suporte respondidas e verificadas pela equipe da Pluggy

É somente leitura e público: o servidor expõe documentação, não sua conta ou dados da Pluggy. Para chamar a própria API da Pluggy, use a Referência da API com suas próprias credenciais.