O GramClaw expõe o mesmo motor do Telegram de duas formas: uma API REST para automação personalizada e um servidor MCP (Model Context Protocol) remoto para agentes de IA. Ambos se autenticam com uma chave de API que você cria em Definições, ambos respeitam a mesma cadência por conta que mantém as suas contas do Telegram saudáveis e ambos exigem uma subscrição ou período de avaliação ativo.
Na prática: a API REST é para código — sincronizar contactos a partir do seu produto, acionar uma campanha quando um utilizador se inscreve, canalizar conversas para o seu data warehouse. O servidor MCP é para agentes — o Claude Desktop, o Claude Code, o Cursor ou o seu próprio agente obtêm ferramentas para listar conversas, ler mensagens, enviar respostas, executar transmissões e gerir o pipeline, sem escrever código.
Criar uma chave de API
- 1
Abra Definições → Chaves de API
Gere uma chave e escolha os seus escopos — leitura para listar e ler dados, envio para tudo o que escreve ou envia mensagens. Limite as chaves ao mínimo de que precisam.
- 2
Copie-a uma vez
A chave completa (gc_live_…) é mostrada apenas na criação — guarde-a num gestor de segredos. Se vazar, apague-a em Definições e deixa de funcionar imediatamente.
- 3
Autentique
REST: envie-a como cabeçalho Authorization: Bearer. MCP: coloque-a no URL do servidor como o parâmetro key.
A API REST num minuto
A API cobre a superfície da plataforma: contas, conversas, mensagens, contactos, campanhas, transmissões, colunas do pipeline e análises. Os pedidos são JSON simples sobre HTTPS. A documentação completa dos endpoints — cada rota, os seus escopos e exemplos de pedido/resposta — vive na página de documentação da API, e uma especificação OpenAPI legível por máquina está disponível em /openapi.json para geração de código ou para entregar a um LLM.
Ligar o servidor MCP
- 1
Copie o URL do servidor
https://gramclaw.com/api/mcp?key=gc_live_… — a chave identifica-o e autoriza-o, com escopo nas contas em que pode atuar.
- 2
Adicione-o ao seu cliente MCP
O Claude Desktop, o Claude Code, o Cursor ou qualquer cliente compatível com MCP aceita um URL de servidor remoto. Sem instalação local, sem proxy.
- 3
Peça trabalho a sério
Uma vez ligado, o seu agente pode pesquisar conversas, redigir e enviar respostas, lançar campanhas, verificar o estado das campanhas e mover negócios pelo pipeline — cada envio sujeito à mesma cadência de conta que o resto do GramClaw.
Boas práticas
- Uma chave por integração, nomeada em conformidade, para que revogar uma coisa nunca quebre outra.
- Prefira escopos só de leitura para painéis e trabalhos de análise.
- Rode as chaves quando os colegas saírem e apague as chaves que já não usa — a revogação é instantânea.
- Lembre-se de que os envios por API e MCP são mensagens reais do Telegram das suas contas reais: aplica-se o mesmo critério de consentimento e volume que na aplicação.