Índice e busca do manual
Gerenciar API keys, conexões MCP e webhooks
Na página API e Integrações, crie e revogue API keys, veja e revogue os programas conectados ao MCP, copie a configuração e cadastre webhooks.
6 passos · Conferido em 28 de setembro de 2026
Como você quer ver este tutorial
A página API e Integrações
Esta página das Configurações reúne o que conecta a naia a ferramentas externas: API keys, conexões MCP feitas com login, a configuração rápida do MCP e webhooks. Ela vale para a sua conta. Entre Conexões MCP e Configuração rápida a página tem ainda a seção WhatsApp Autopilot, explicada no tutorial de WhatsApp. Para conectar o MCP sem API key, veja o tutorial da Central de integrações.
O que dá para fazer
- Criar até três API keys ativas e revogar as que não usa mais.
- Revogar um programa conectado ao MCP por login.
- Copiar a configuração do MCP para Claude Code, Cursor, Windsurf, Codex, npm, Replit, Lovable e Bolt.
- Receber avisos de eventos da naia em um endereço seu, com webhooks.
Tipos disponíveis
| Tipo | O que é |
|---|---|
| Escopo AI Readiness | Usar somente a API de AI Readiness para sites parceiros. |
| Escopo Leitura | Consultar dados de análises, empresas e conteúdo. |
| Escopo Escrita | Criar análises, empresas e conteúdo. |
| Escopo Administração | Gerenciar configurações, integrações e a equipe das organizações: convidar, mudar papel, remover membro e mover marca. |
| Evento Análise concluída | Avisa quando uma análise termina. |
| Evento Análise falhou | Avisa quando uma análise falha. |
| Evento Conteúdo gerado | Avisa quando um conteúdo fica pronto. |
| Evento Geração de conteúdo falhou | Avisa quando a geração de um conteúdo falha. |
| Evento Plano de execução pronto | Avisa quando um plano de execução fica pronto. |
| Evento Autopilot concluído | Avisa quando uma rodada do Autopilot termina. |
| Evento Autopilot falhou | Avisa quando uma rodada do Autopilot falha. |
Passo a passo
Passo 1: Abra a página API e Integrações
No menu lateral, o item API/MCP, na seção Gestão, abre esta página. O botão Saiba mais do aviso do MCP no Autopilot também leva até ela. O topo diz API e Integrações e resume o que a página gerencia: API keys, webhooks, MCP remoto e npm stdio. O botão Ver documentação abre a documentação para desenvolvedores em uma nova aba.
O que dá para fazer
- Abrir a documentação para desenvolvedores em nova aba.
- Voltar a esta página sempre pelo item API/MCP do menu.
Passo 2: Crie uma API key
Criar API Key abre o diálogo Criar nova API Key: escreva o Nome (por exemplo, o programa que vai usar a key) e marque os Escopos. Leitura e Escrita vêm marcados. Depois de criar, a key aparece completa uma única vez, com o aviso Esta key será exibida apenas uma vez: copie e guarde antes de clicar em Entendido, já copiei. O limite é de três keys ativas; com três, o botão fica desativado e a página avisa Limite de 3 keys ativas atingido. Ver consumo leva à página de créditos, já na aba Consumo API.
O que dá para fazer
- Escolher só os escopos de que o programa precisa.
- Copiar a key na hora, porque ela não é mostrada de novo.
- Ver quanto a API já consumiu em Ver consumo.
Passo 3: Acompanhe e revogue as keys
Cada key mostra o nome, o início do código, a data de criação, o Último uso e os escopos, em selos. A lixeira abre Revogar API Key: todas as integrações que usam a key deixam de funcionar imediatamente. As keys revogadas ficam na lista Revogadas, com o nome riscado e o selo Revogada.
O que dá para fazer
- Descobrir quais keys ficaram sem uso e revogar.
- Revogar uma key vazada sem afetar as outras.
Passo 4: Veja os programas conectados ao MCP
Conexões MCP lista os programas que se conectaram ao MCP com login universal, sem API key. Cada linha mostra o nome do programa, Conectado em, Último uso e Expira em, e a conexão dura até 180 dias. Revogar abre Revogar conexão MCP: o programa perde o acesso na hora e precisa de uma nova aprovação para reconectar. Sem nenhuma conexão, a lista mostra Nenhum cliente conectado via OAuth.
O que dá para fazer
- Conferir quando cada programa vai precisar de nova aprovação.
- Revogar um programa que você não usa mais.
Passo 5: Copie a configuração rápida
Três quadros resumem os caminhos: MCP remoto, com a URL https://naia.today/api/v1/mcp e login por navegador, sem API key; MCP Registry, com today.naia/platform, para clientes que descobrem servidores; e npm stdio, para clientes que só aceitam comando local e exigem API key no ambiente. As abas Claude Code, Cursor, Windsurf, Codex, npm, Replit, Lovable e Bolt trazem o comando ou o trecho de cada programa, com botão de copiar. A aba npm avisa quando você ainda não tem API key ativa.
O que dá para fazer
- Copiar o comando do programa que você usa.
- Usar o npm stdio só quando o programa não aceitar a URL direta.
Passo 6: Cadastre um webhook
Criar Webhook pede a URL do endpoint, que deve usar HTTPS e recebe requisições POST com payload JSON, e os Eventos que você quer receber. O botão só ativa com uma URL e pelo menos um evento. Ao criar, a naia mostra o Signing Secret uma única vez, para você validar as requisições no seu endpoint. Cada webhook na lista mostra os eventos, o selo Inativo ou a contagem de falhas quando houver, o botão Enviar teste e a lixeira Remover webhook.
O que dá para fazer
- Escolher quais eventos disparam o aviso.
- Enviar um teste para conferir se o seu endpoint responde.
- Remover um webhook que não é mais usado.