Servidor MCP

A servidor do Protocolo de Contexto do Modelo (MCP) da Pluggy permite que qualquer agente de IA leia a documentação, guias, referência da API, changelog, receitas e perguntas e respostas 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 fundamentado na documentação ao vivo — com citações.

O servidor está hospedado em:

https://mcp.pluggy.ai/mcp

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

O servidor agora vive em seu próprio endereço, então permanece o mesmo mesmo que o site de documentação se mova mais tarde — https://mcp.pluggy.ai/mcp é a URL a ser usada a partir de agora. A anterior, https://v2.docs.pluggy.ai/api/mcp, continua funcionando, então qualquer coisa que você já configurou está bem como está.

Uma URL, login opcional — o mesmo servidor para todos:

• Sem fazer login → as ferramentas de documentação pública (docs, referência da API, changelog, receitas, perguntas e respostas).
• Logado com sua conta do dashboard da Pluggy → o acima mais suas ferramentas de portal de desenvolvedor — suas equipes, aplicações, conectores, itens e uso — limitados à sua equipe. O login é opcional; use-o anonimamente para docs, ou conecte-o aos seus dados.

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 token de conexão e abro o Connect Widget?" → passos fundamentados nos guias ao vivo.
• "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 curadas, verificadas por humanos, que responderam 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 reensina seu agente.

Ferramentas disponíveis#

Conecte-o à sua ferramenta#

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

Claude Code#

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

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

Claude Desktop#

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

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

ChatGPT (OpenAI)#

Em Configurações → Conectores → Avançado → Modo desenvolvedor, adicione um conector com a URL https://mcp.pluggy.ai/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://mcp.pluggy.ai/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://mcp.pluggy.ai/mcp"
    }
  }
}

VS Code (modo agente do GitHub Copilot)#

Um comando:

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

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

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

Windsurf#

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

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

Gemini CLI#

Adicione a ~/.gemini/settings.json:

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

Zed#

Adicione ao seu settings.json do Zed:

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

Qualquer outro cliente MCP#

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

npx -y mcp-remote https://mcp.pluggy.ai/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 os docs da Pluggy MCP, como eu crio um token de conexão e abro o Connect Widget?

ou

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

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

O que ele expõe#

O servidor cobre tudo publicado neste site:

• Guias de documentação — conceitos, início rápido 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

Logado (sua conta do dashboard da Pluggy), o mesmo servidor também expõe seu portal de desenvolvedor, limitado à sua equipe: liste suas equipes e aplicações, conectores, itens e estatísticas de uso. Seu token é validado e usado apenas para acessar os dados da sua própria equipe — nunca os de outro cliente, e nunca o conhecimento interno da Pluggy.

As ferramentas de documentação são somente leitura e públicas; as ferramentas do portal de desenvolvedor requerem login. Para chamar a API do produto Pluggy diretamente, use a Referência da APIAPI com suas próprias credenciais.

Seus próprios dados: as ferramentas do portal de desenvolvedor#

Faça login e o agente pode responder perguntas sobre sua integração, não apenas sobre a documentação — por que um item está falhando, o que um webhook entregou, quanto você ingeriu no mês passado.

A primeira chamada pede que você faça login com a mesma conta que usa no Dashboard, através do fluxo de autorização normal do seu cliente MCP. Não há chave de API para colar, e seu clientSecret nunca chega ao agente: as ferramentas leem o portal de desenvolvedor em nome do seu usuário, limitado às equipes que esse usuário já pode ver.

Uma sessão geralmente vai: list_teams → list_applications → select_application, e a partir daí as ferramentas de dados reutilizam essa equipe e aplicação. Pedir ao agente para "usar minha aplicação sandbox" é suficiente — ele faz essas chamadas por conta própria.

O que perguntar#

Por que o item 8a7c… está preso? Use as ferramentas do portal de desenvolvedor da Pluggy.

Liste os eventos de webhook que minha aplicação de produção entregou hoje e abra o último que falhou.

Quantas transações nós ingerimos no mês passado em comparação com o anterior?

Quando algo não funciona#

• O agente nunca chama as ferramentas. Reinicie o cliente após adicionar o servidor — a maioria só lê sua configuração MCP na inicialização — e verifique se a URL é exatamente https://mcp.pluggy.ai/mcp.
• "Não autenticado" em uma ferramenta do portal de desenvolvedor. O cliente está configurado para fazer login apenas sob demanda; veja a nota acima.
• A resposta parece desatualizada. As ferramentas leem o site publicado, então qualquer coisa que ainda não foi publicada não é visível para elas também. Verifique a página em v2.docs.pluggy.ai.
• Seu cliente só fala stdio. Faça a ponte com npx -y mcp-remote https://mcp.pluggy.ai/mcp.