Pular para o conteúdo principal

MCP para agentes de IA

A Ishtaran tem um servidor MCP (Model Context Protocol) oficial para agentes de IA. Se você está construindo com Claude, Codex, Cursor ou qualquer outro cliente compatível com MCP, conecte-o antes de escrever qualquer linha de código de integração — ele ensina ao agente as capacidades reais da Ishtaran, planeja uma integração e valida um plano proposto, fundamentado no contrato público real da API e nos SDKs, e não em suposições do modelo.

LLM pensa  ->  MCP ensina/planeja/valida  ->  SDK executa a integração  ->  API executa o negócio

O @ishtaran/mcp nunca executa operações financeiras — nenhum depósito, settlement, payout, withdrawal ou refund. Ele só conhece, planeja e valida. Sua integração continua rodando em um dos SDKs oficiais; o MCP só garante que o agente construindo a integração não alucine um endpoint, método de SDK, código de erro ou evento de webhook que não existe.

Instalação​

Nenhuma API Key ou variável de ambiente é necessária — todas as tools e resources funcionam totalmente offline, logo após a instalação.

Claude Code​

Adicione ao .mcp.json do seu projeto (ou rode claude mcp add):

{
  "mcpServers": {
    "ishtaran": {
      "command": "npx",
      "args": ["-y", "@ishtaran/mcp"]
    }
  }
}

Cursor​

Settings → MCP → Add new MCP server, mesmo command/args acima.

VS Code (ou qualquer outro cliente MCP baseado em stdio)​

Aponte o cliente para o comando npx -y @ishtaran/mcp sem argumentos.

O que ele conhece​

  • Capabilities e operações — toda operação pública da API, com o método real de SDK por linguagem (TypeScript, Java, Python e Go), extraído diretamente do código-fonte de cada SDK.
  • Erros — significado, se é retryable e a remediação real de cada código de erro documentado.
  • Webhooks — o contrato completo de entrega (headers, fórmula de assinatura HMAC, regras de retry/ordem) e o catálogo real de eventos.
  • Recipes — padrões completos de integração (começando pelo exemplo de marketplace Mercatto), incluindo invariantes e anti-padrões conhecidos.
  • Gaps conhecidos — o que a plataforma genuinamente ainda não suporta, para o agente nunca inventar um workaround para algo que nunca foi possível.

Pergunte coisas como "Como eu integro a Ishtaran?", "Construa um marketplace usando a Ishtaran", "Como eu verifico um webhook da Ishtaran?" ou "Explique NETWORK_EXECUTION_FEE_INSUFFICIENT_BALANCE."

Se manter atualizado sem reinstalar​

A versão do pacote do MCP e o conhecimento que ele carrega (docs, superfície da API, recipes, reference projects) são versionados de forma independente. Novas docs, rotas, capabilities, recipes ou reference projects chegam a um MCP já instalado através de uma pequena atualização de conhecimento, assinada e content-addressed, que ele verifica em segundo plano — você não precisa rodar npx @ishtaran/mcp de novo nem reinstalar nada para recebê-los. Veja o README do repositório para o funcionamento exato disso.

Código-fonte​

O @ishtaran/mcp é Apache-2.0 e público: github.com/taylorjeftedasilva/ishtaran-mcp · npm