Como conectar a Coloquia ao Claude Code (terminal)
Conecte a Coloquia ao Claude Code com um único comando copiado do portal, já com a sua chave de acesso.
O Claude Code é a versão do Claude que roda no terminal (a janela de comandos do computador). Ele já pode se conectar à Coloquia: no portal, o cartão dele aparece como "Pronto".
Jeito mais rápido: no portal, em Conectar a IA, clique em Copiar instrução e cole na sua IA: ela mesma instala. Veja Peça para a sua IA instalar. O passo a passo abaixo é para quem prefere fazer à mão.
Copiar o comando pronto
- No portal, abra Conectar a IA e depois Prefiro configurar eu mesmo.
- No cartão Claude Code, clique em Copiar comando (com a chave).
- Cole o comando no terminal e aperte Enter.
- Abra o Claude Code e pergunte: "Quem me escreveu hoje e ainda está sem resposta?"
Se preferir montar o comando
O comando tem este formato:
claude mcp add --transport http coloquia <SEU_ENDERECO> --header "Authorization: Bearer <SUA_CHAVE>"
<SEU_ENDERECO>: o seu endereço Coloquia, na página Conectar a IA, em Prefiro configurar eu mesmo (botão Copiar).<SUA_CHAVE>: a sua chave de acesso, uma espécie de senha que identifica você para a Coloquia. No mesmo bloco, abra Avançado: chave de acesso e clique em Mostrar ou Copiar. Ela fica escondida até você clicar.
Cuide da sua chave
- Trate a chave como uma senha. Quem tiver a chave consegue ler e enviar mensagens pelo seu número.
- Não cole a chave em e-mails, grupos ou documentos compartilhados.
- Se achar que alguém viu a sua chave, clique em Gerar chave nova. A chave anterior continua valendo por 60 minutos, para você atualizar o comando sem ficar sem conexão. Veja o artigo sobre gerar chave nova.
Outros apps que pedem "cabeçalho de autorização"
Alguns apps (por exemplo, o Cursor) pedem o endereço e a chave num arquivo de configuração. Em Conectar a IA → Prefiro configurar eu mesmo → Avançado: chave de acesso há um modelo pronto: clique em Copiar configuração (com a chave) e cole no app.