O OpenCode é um agente de IA com suporte a servidores MCP. Ele pode se conectar ao servidor local do Deskgram 2 para consultar ferramentas permitidas, esquemas de módulos e tarefas. O modelo usado pelo OpenCode é configurado separadamente.
Preparar o Deskgram
Inicie o Deskgram, abra os ajustes MCP, defina um token, ative o listener e salve. O endereço padrão é http://127.0.0.1:8765/mcp. Se mudou a porta, use o novo valor no agente.
Na primeira verificação, mantenha o modo de leitura e habilite apenas o necessário. O catálogo MCP real mostra as ferramentas da sua versão.
Configurar o OpenCode
Adicione este servidor à configuração. Antes de iniciar o agente, defina DESKGRAM_MCP_TOKEN com o mesmo token salvo no Deskgram.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"deskgram": {
"type": "remote",
"url": "http://127.0.0.1:8765/mcp",
"headers": { "Authorization": "Bearer {env:DESKGRAM_MCP_TOKEN}" },
"oauth": false,
"enabled": true
}
}
}
Se já existem servidores, acrescente deskgram ao objeto mcp, preservando os demais. oauth: false usa Bearer em vez de tentar OAuth automaticamente.
127.0.0.1 aponta para o ambiente onde o OpenCode está sendo executado. Em contêineres ou servidores remotos, não aponta automaticamente para o Deskgram do seu computador.
Verificar sem executar tarefas
Execute opencode mcp list. Peça ao agente para chamar deskgram_health e deskgram_list_modules. Consulte os parâmetros com deskgram_get_module_schema, por exemplo para profile_setup.
Ler o esquema não inicia o módulo. Antes de criar uma tarefa, revise contas, parâmetros, permissões MCP e modo de execução. Operações de escrita podem exigir permissões adicionais; uma ferramenta listada não está necessariamente habilitada.
OpenCode e OpenRouter
O OpenCode gerencia a conversa e as chamadas MCP; o OpenRouter fornece modelos. Se usar OpenRouter no agente, configure a chave e a cobrança separadamente. Uma chave salva no Deskgram não configura o OpenCode nem libera acesso MCP.
Erros e documentação
Sem conexão, confira Deskgram, listener, porta e /mcp. Para falhas de autorização, revise a variável e o cabeçalho Bearer; reinicie o OpenCode após alterar o ambiente. Um GET do navegador com resposta405 não testa a troca MCP: use o cliente.
Consulte OpenCode MCP, MCP do Deskgram e o guia OpenRouter.
Condições e divulgação
O custo do modelo depende do provedor escolhido. O botão abre o site oficial sem código de indicação. Este guia não implica parceria oficial.
Configurações verificadas em 20 de outubro de 2026.