Acesso API & MCP

Acesso API & MCP

O Metricgram inclui uma API pública e um servidor MCP para conectar suas próprias ferramentas, dashboards, automações ou clientes de IA aos dados e operações disponíveis na sua conta.

O acesso API & MCP está disponível no plano Elite. Se sua conta não incluir esse recurso, a seção API & MCP pode aparecer bloqueada ou mostrar uma mensagem de upgrade.

Onde encontrar

Abra Integrações > API & MCP no painel de gestão. Contas com acesso podem criar tokens de API, revisar tokens ativos, revogar tokens e ver a referência técnica disponível para o plano.

Como os tokens funcionam

• Os tokens pertencem à sua conta de usuário do Metricgram, não a um grupo específico.
• Um token pode acessar os grupos e recursos que sua conta pode gerenciar.
• Os tokens incluem permissões para áreas como grupos, membros, mensagens, automações, assinantes, análises, tickets de suporte, indicações e MCP.
• Alguns endpoints apenas leem dados; outros podem criar, atualizar, moderar ou executar ações conforme as permissões do token.
• O valor do token é exibido apenas uma vez ao ser criado. Guarde-o com segurança.

Autenticação e limites

As requisições da API usam o cabeçalho Authorization: Bearer mg_.... O limite padrão é de 600 requisições por minuto por token, e o formulário permite escolher um valor dentro do mínimo e máximo permitidos pelo app.

Se um token for revogado, se a conta perder acesso à API ou se o plano deixar de incluir API & MCP, as requisições com esse token serão rejeitadas.

Boas práticas

• Crie tokens separados para cada ferramenta externa.
• Use nomes claros para identificar onde cada token é usado.
• Revogue tokens que você não usa mais.
• Não compartilhe tokens em chats, capturas de tela, tickets ou repositórios públicos.