API pública

Conectar um assistente de IA (MCP)

Crie uma chave de API só com os escopos de que o assistente precisa e dê ao cliente o endereço https://api.mosaqo.app/v1/mcp com essa chave como token bearer. O assistente faz exatamente o que a chave permite e nada além disso, e você pode desconectá-lo quando quiser em Bulk & API.

Revisado em 20 de agosto de 2026

Passos

1. Abra Bulk & API → API keys e crie uma chave. Conceda primeiro escopos só de leitura; emita outra com escrita quando souber o que o assistente faz.
2. Copie o endereço do bloco AI assistants (MCP) na mesma tela.
3. No assistente, adicione um servidor com esse endereço e envie a chave no cabeçalho Authorization: Bearer. A maioria dos clientes aceita um bloco JSON com url e headers.
4. Alguns conectores pedem que você entre no Mosaqo em vez de colar uma chave. Esse caminho mostra quem está pedindo, qual espaço seria afetado e o que ele poderia fazer, antes de conceder qualquer coisa — só um proprietário ou administrador pode aprovar.
5. Pergunte ao assistente o que ele sabe fazer. Ele vai listar as ferramentas que sua chave permite, que é a confirmação mais rápida de que a conexão está no escopo que você queria.

Como conferir o resultado

Pergunte algo que só este espaço sabe: quantos códigos você tem, ou como vai uma pesquisa. Uma resposta com seus nomes e números reais significa que a conexão funciona; uma recusa citando um escopo significa que a chave é mais estreita que a pergunta.

O que costuma dar errado

• Dar escrita já na primeira chave. Comece com leitura e amplie quando souber o que ele faz com isso.
• Esperar que ele leia o que as pessoas escreveram numa pesquisa. Essas respostas não vão para chave nem para assistente — notas e contagens sim, as frases ficam na caixa de entrada.
• Esperar que ele apague um código. Não pode: destruir o redirecionamento de um código impresso é irreversível, então lhe é oferecido arquivar, que se reverte.
• Esquecer uma conexão. Um assistente conectado por login mantém o acesso até ser desconectado em Bulk & API, assim como uma chave vale até ser revogada.