Conectar
Conecta o sistema aos apps do usuário através de um gateway de ferramentas: um único servidor MCP (Composio) a partir do qual cada aplicativo é autorizado. Avance um passo de cada vez e aguarde a confirmação do usuário antes do próximo.
Antes de começar
- Leia
opencode.jsonememory/wiki/conexoes.md(se existir). Se o Composio já estiver habilitado, pule para o passo 4. - Diga em uma linha o que você vai fazer e que a meta mínima é um app conectado.
Passo 1 · Conta e chave
Peça que ele faça isso, no navegador:
- Acessar https://composio.dev e criar uma conta com seu Gmail pessoal (o e-mail da universidade pode bloquear a autorização). O plano gratuito não pede cartão.
- No painel, abrir AI Clients e copiar sua consumer API key.
Não peça que ele cole a chave no chat. O que é escrito aqui pode ficar no histórico.
Passo 2 · Salvar a chave no computador dele
A chave vai em uma variável de ambiente, fora do repositório. Dê o comando conforme o sistema e peça que ele execute em outro terminal:
# macOS / Linux (zsh); no bash use ~/.bashrc
echo 'export COMPOSIO_CONSUMER_KEY="cole-aqui-sua-chave"' >> ~/.zshrc && source ~/.zshrc
# Windows (PowerShell)
setx COMPOSIO_CONSUMER_KEY "cole-aqui-sua-chave"
No Windows, setx só se aplica a terminais novos: é preciso fechar e abrir o terminal.
Passo 3 · Habilitar Composio
Peça permissão e altere em opencode.json o bloco mcp.composio para "enabled": true. Não mude mais nada.
Em seguida, peça que ele feche o OpenCode e o reabra nesta pasta, em um terminal novo, e execute:
opencode mcp list
Composio deve aparecer conectado. Se não:
opencode mcp debug composiomostra o erro.- Se disser que falta a chave, a variável não chegou a este terminal: repita o passo 2 e abra um terminal novo.
Passo 4 · Conectar o primeiro app
Quando ele voltar, pergunte qual conectar primeiro (sugira Google Calendar). Use a ferramenta do Composio que gerencia conexões para gerar o link de autorização, entregue-o e aguarde que ele autorize no navegador e retorne ao chat.
Verifique com uma leitura simples: os eventos de hoje, ou os três últimos assuntos do e-mail. Mostre o resultado.
Se sobrar tempo, repita com um segundo app.
Passo 5 · Registrar
Crie ou atualize memory/wiki/conexoes.md com: quais apps estão conectados, a data e para que ele os usa. Sem chaves nem e-mails. Vincule-o a partir de memory/index.md.
Encerre com: «Teste /brief para ver seu dia».
Plano B · sem MCP
Se o MCP não conectar, a CLI do Composio serve igual:
curl -fsSL https://composio.dev/install | sh # depois abrir um terminal novo
composio login # se não fizer nada: composio logout e depois composio login --no-wait
composio link googlecalendar
composio search "list today's calendar events"
composio execute <SLUG> --dry-run -d '{...}'
Regras
- Ler antes de escrever. Para verificar uma conexão, apenas leituras.
- Nunca execute uma ação que envie, crie, atualize ou apague algo sem que o usuário a aprove explicitamente, mesmo que o OpenCode já esteja pedindo permissão.
- Nunca escreva chaves em arquivos do repositório. Se o usuário colar uma no chat, diga para ele regenerá-la no painel.
- Se algo falhar duas vezes, pare, diga o que falhou e ofereça o plano B. Não improvise mudanças na configuração.