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#
| Ferramenta | O que faz |
|---|---|
query | Faç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_docs | Pesquise os guias de documentação (conceitos, quickstart, integração) com trechos classificados por relevância |
search_qa | Pesquise 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_changelog | Pesquise o changelog — notas de lançamento, mudanças significativas, notas de migração |
search_recipes | Pesquise as receitas — padrões de integração, exemplos de código |
get_guide | Recupere o conteúdo completo de um único guia de documentação pelo slug e localidade |
list_guides | Liste todos os guias de documentação (slug, título, descrição, categoria) para uma localidade |
get_api_endpoint | Obtenha detalhes completos de um endpoint da API pelo operationId — método, caminho, parâmetros, corpo da requisição, respostas |
list_endpoints | Liste 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/mcpAdicione -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/mcpClientes 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.
