Conecte um cliente MCP e deixe o agente se cotar

Um endpoint, Streamable HTTP

O servidor fala JSON-RPC 2.0 sobre Streamable HTTP num único endpoint. Chame tools/list para descobrir as ferramentas que seu token realmente alcança, em vez de confiar numa lista copiada de uma página como esta.

# JSON-RPC 2.0 over Streamable HTTP, one endpoint.
curl -X POST https://api.qannasapi.com/mcp \
  -H "Authorization: Bearer $QANNAS_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

# Trust this over any tool list copied from a page — it reflects
# the scopes your token actually carries.

Crie um token com escopo limitado

Os tokens aparecem uma única vez na criação e carregam escopos somente leitura, negando por padrão. Não existe escopo de escrita a reter: um token pode consultar e nunca pode alterar, enviar ou apagar nada. A revogação é imediata.

// Any client with a custom-headers field connects today.
{
  "mcpServers": {
    "qannas": {
      "url": "https://api.qannasapi.com/mcp",
      "headers": {
        "Authorization": "Bearer qm_…"
      }
    }
  }
}

// The token is shown once at creation. Store it then.

Faça o agente cotar primeiro

As ferramentas de fluxo aceitam uma cotação dry_run, e pedi-la não custa nada. Ponha a instrução no prompt de sistema — cotar primeiro e esperar aprovação — para que o agente proponha um custo antes de gastar.

# Put this in the agent's system prompt.
# A dry_run quote is free, so there is no reason not to.

Before running any QannasAPI workflow tool, call it once with
dry_run: true, show me the credit quote, and wait for my
approval before running it for real.

Saiba o que o MCP não carrega

O rastreio por delta é exclusivo do REST: since_cursor e track_delta não são expostos no MCP. As buscas de contato por consenso também são exclusivas do REST. E chamadas via MCP sempre cobram créditos reais — não há modo de chave de teste nessa superfície.

Resumo

Checklist de produção

• Chame tools/list no seu próprio token em vez de fixar uma lista de ferramentas no código.
• Ponha «cote primeiro, espere aprovação» no prompt de sistema do agente.
• Crie um token por agente, para que revogar um não atrapalhe os demais.
• Guarde o token na criação — ele não é exibido de novo.

Próximos passos