Developer MCP
Assistente com IA para desenvolvedores que integram a API Conta Simples
Visão geral
O servidor Developer MCP dá a agentes de IA acesso direto à documentação da API Conta Simples. Ele permite que seu assistente de IA entenda endpoints, gere código de integração, explique erros e ajude você a desenvolver mais rápido.
O Developer MCP não acessa dados reais nem executa operações na plataforma Conta Simples. Trata-se de um assistente somente leitura, focado em acelerar a integração com a API.
O que você pode fazer
Use o Developer MCP para fazer perguntas ao seu assistente de IA, como:
-
"Como me autenticar na API Conta Simples?"
-
"Mostre o corpo da requisição para listar transações de cartão"
-
"Quais escopos preciso para bloquear um cartão?"
-
"Gere um script em Python para buscar extratos bancários"
-
"O que significa o código de erro 429 na API Conta Simples?"
-
"Como funciona a paginação no endpoint de extratos?"
O assistente recupera a documentação relevante e responde com precisão e contexto.
Configuração
Não são necessárias chaves de API nem autenticação para o Developer MCP. Ele oferece acesso público à documentação, otimizado para consumo por IA.
Adicione o seguinte à configuração de MCP no Cursor (Configurações → Cursor Settings → MCP):
{
"mcpServers": {
"conta-simples-docs": {
"url": "https://developers.contasimples.com/_mcp"
}
}
}
Adicione o seguinte ao seu claude_desktop_config.json:
{
"mcpServers": {
"conta-simples-docs": {
"url": "https://developers.contasimples.com/_mcp"
}
}
}
Adicione o servidor MCP nas configurações do Windsurf usando a URL:
https://developers.contasimples.com/_mcp
Recursos disponíveis
O Developer MCP expõe a documentação da API Conta Simples como contexto estruturado que agentes de IA podem consultar, incluindo:
| Recurso | Descrição |
|---|---|
| Descoberta de endpoints | Encontrar e entender todos os endpoints disponíveis |
| Referência de parâmetros | Detalhes de parâmetros de requisição, tipos e requisitos |
| Esquemas de resposta | Estruturas de resposta e descrição de campos |
| Guias de autenticação | Como OAuth 2.0 e gestão de tokens funcionam |
| Geração de código | Geração de código de integração em várias linguagens |
| Diagnóstico de erros | Códigos de erro e passos de solução de problemas |
| Boas práticas | Recomendações sobre paginação, repetição de requisições (retry) e mais |
Exemplos de interação
Entender um endpoint
Você: "Quais parâmetros o endpoint de transações de cartão aceita?"
Assistente: O endpoint GET /statements/v1/credit-card aceita os seguintes parâmetros no corpo da requisição:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
startDate | string | Sim | Data inicial no formato AAAA-MM-DD |
endDate | string | Sim | Data final no formato AAAA-MM-DD |
limit | integer | Sim | Resultados por página (5 a 100) |
nextPageStartKey | string | Não | Cursor para paginação |
Gerar código de integração
Você: "Gere uma função Node.js para autenticar e buscar transações de cartão"
O assistente produz um exemplo completo e executável, com endpoints, fluxo de autenticação e tratamento de erros de acordo com a documentação oficial.
Como funciona
-
O assistente de IA envia uma consulta ao servidor Developer MCP
-
O servidor MCP busca na documentação da API Conta Simples
-
Trechos relevantes retornam como contexto estruturado
-
O assistente de IA usa esse contexto para responder com precisão
Limitações
-
O Developer MCP oferece apenas documentação — não executa chamadas de API nem acessa dados ao vivo
-
As informações refletem a documentação publicada no momento
-
Para ações operacionais, use o Conta Simples MCP