Pular para o conteúdo

Turbo Notify no OpenCode

No OpenCode, o Turbo Notify entra como servidor MCP, adicionado por um comando, e a skill do atendente virtual se instala com npx skills. O OpenCode não tem marketplace de skills nem executor do atendente: o atendente trabalha em modo assistido, com uma pessoa aprovando cada resposta, e nada é respondido enquanto o OpenCode está fechado.

  • Uma conta do Turbo Notify com um número conectado (começo rápido).
  • O OpenCode instalado.
  • Para a skill: Node.js 22.20 ou mais novo (exigência do npx skills) e Python 3.9 ou mais novo.

O servidor MCP:

Janela do terminal
opencode mcp add turbo-notify --url https://mcp.turbonotify.com

O comando grava a entrada no opencode.json. Confira o resultado com opencode mcp list.

A skill:

Janela do terminal
npx skills add turbo-notify/agent-skills -a opencode

Sem o -g, a skill é instalada na pasta do projeto atual (.agents/skills/), que o OpenCode lê. Com -g, ela vai para ~/.config/opencode/skills/ e vale para todos os projetos.

  • Com a sua conta: rode

    Janela do terminal
    opencode mcp auth turbo-notify

    O OpenCode abre o navegador. Entre no Turbo Notify e aprove o acesso; o comando termina com Connected. O OpenCode lista o servidor como connected mesmo antes do login e não oferece o login de novo quando uma chamada de ferramenta é recusada, então rode este comando uma vez.

  • Com uma chave de API: crie a chave em API Keys (abre em nova aba) e acrescente o cabeçalho Authorization: Bearer SUA_CHAVE à entrada do servidor no opencode.json, como a documentação do OpenCode descreve para servidores remotos. Trate a chave como uma senha.

Escopos e chaves estão em Servidor MCP.

Execute opencode mcp list: o turbo-notify deve aparecer na lista, com o estado dele. Depois peça ao agente: “Liste os meus números do WhatsApp no Turbo Notify.” Ele chama list_numbers, que só lê. Nada é enviado.

Para a skill, peça: “Configure o atendente virtual do Turbo Notify.”

Janela do terminal
npx skills update

O servidor MCP não precisa de atualização: o endereço é sempre o mesmo.

  • Modo assistido apenas, com você presente. Cada resposta precisa de aprovação.
  • As ferramentas seguem os limites da API: 600 requisições por minuto por chave ou login, além da cota e do ritmo de envio do plano. Veja Limites do servidor MCP.
  • Uma chamada de ferramenta pelo agente depois do login. O login em si foi feito de ponta a ponta em 3 de novembro de 2026 (OpenCode 2.1.4); a chamada não foi, porque precisa de um provedor de modelo.
  • A skill dentro do OpenCode. A pasta de instalação segue a documentação do npx skills e do OpenCode, e não rodamos o atendente nesse agente.
  • O cabeçalho com a chave de API no opencode.json. O formato do arquivo mudou entre as versões do OpenCode que vimos, então esta página não o reproduz: confira a documentação da sua versão.