MCP (Model Context Protocol) \u00e9 um protocolo aberto que descreve como conectar ferramentas externas e fontes de dados ao modelo de linguagem: um sistema de arquivos, documenta\u00e7\u00e3o, rastreador de tarefas, rastreador de bugs ou seu pr\u00f3prio servi\u00e7o. Em vez de incorporar cada ferramenta ao agente, voc\u00ea configura um servidor MCP separado e o agente se comunica com ele de acordo com o esquema padr\u00e3o.<\/p>\n
OpenCode oferece suporte a MCP pronto para uso: tanto servidores locais, que s\u00e3o iniciados por um processo filho, quanto servidores remotos, acess\u00edveis via HTTP. Um ponto importante \u00e9 que toda a camada MCP \u00e9 implementada do lado do pr\u00f3prio OpenCode, e n\u00e3o do lado do provedor do modelo. Portanto, o DeepSeek recebe ferramentas MCP como fun\u00e7\u00f5es normais na solicita\u00e7\u00e3o, e n\u00e3o precisa saber nada sobre o protocolo em si.<\/p>\n
Neste post, veremos como adicionar um servidor local e remoto, como obter autoriza\u00e7\u00e3o, como n\u00e3o se afogar em tokens e o que considerar ao trabalhar com modelos DeepSeek.<\/p>\n
Para funcionar voc\u00ea precisa de tr\u00eas coisas:<\/p>\n
Os servidores s\u00e3o descritos na configura\u00e7\u00e3o do OpenCode no bloco mcp<\/b>. Cada servidor possui um nome exclusivo pelo qual pode ser mencionado em uma solicita\u00e7\u00e3o. As ferramentas do servidor s\u00e3o registradas com esse prefixo de nome, portanto, n\u00e3o h\u00e1 conflitos entre servidores diferentes.<\/p>\n
Ap\u00f3s a conex\u00e3o, as ferramentas MCP ficam dispon\u00edveis para os modelos junto com as integradas: leitura de arquivos, edi\u00e7\u00e3o de c\u00f3digo e execu\u00e7\u00e3o de comandos. Do ponto de vista do DeepSeek, essas s\u00e3o fun\u00e7\u00f5es comuns que um agente pode chamar \u2013 e \u00e9 por isso que o pacote funciona sem qualquer suporte MCP no lado da API do modelo.<\/p>\n
A maneira mais f\u00e1cil de se familiarizar com o mecanismo \u00e9 o servidor de teste @modelcontextprotocol\/server-everything<\/b>. Vamos adicion\u00e1-lo ao arquivo opencode.json<\/b> na raiz do projeto:<\/p>\n O campo comando<\/b> \u00e9 o comando de inicializa\u00e7\u00e3o do servidor e seus argumentos na forma de um array. Ap\u00f3s reiniciar o OpenCode, as ferramentas aparecer\u00e3o na sess\u00e3o e poder\u00e3o ser solicitadas explicitamente:<\/p>\n O servidor local possui v\u00e1rios campos mais \u00fateis. environment<\/b> define as vari\u00e1veis \u200b\u200bde ambiente do processo, cwd<\/b> – o diret\u00f3rio de trabalho, timeout<\/b> – tempo limite da solicita\u00e7\u00e3o em milissegundos e enabled<\/b> permite desabilitar temporariamente o servidor sem remov\u00ea-lo da configura\u00e7\u00e3o.<\/p>\n Servidores remotos s\u00e3o mais convenientes: voc\u00ea n\u00e3o precisa executar nada localmente e podem ser acessados \u200b\u200bvia URL. Um bom exemplo \u00e9 o Context7, que procura documenta\u00e7\u00e3o de biblioteca atualizada. Ele se conecta sem chave:<\/p>\n Se voc\u00ea possui uma conta Context7 gratuita, o segredo \u00e9 aumentar os limites. Os cabe\u00e7alhos s\u00e3o transmitidos atrav\u00e9s do bloco headers<\/b> e \u00e9 conveniente manter a pr\u00f3pria chave em uma vari\u00e1vel de ambiente:<\/p>\n A constru\u00e7\u00e3o {env:NAME}<\/b> substitui o valor da vari\u00e1vel de ambiente ao carregar a configura\u00e7\u00e3o, para que a chave n\u00e3o acabe no reposit\u00f3rio. Antes de iniciar o agente, a vari\u00e1vel deve ser exportada no terminal.<\/p>\n Outro servidor p\u00fablico \u00fatil \u00e9 o Grep da Vercel, procure exemplos de c\u00f3digo no GitHub:<\/p>\n Alguns servidores remotos requerem OAuth. O OpenCode pode passar por esse cen\u00e1rio sozinho: ele percebe a resposta 401, aciona a autoriza\u00e7\u00e3o e salva os tokens. Para Sentry, basta especificar o servidor:<\/p>\n Depois disso, a autoriza\u00e7\u00e3o pode ser iniciada manualmente – o navegador ser\u00e1 aberto:<\/p>\n Os comandos de servi\u00e7o tamb\u00e9m s\u00e3o \u00fateis no trabalho di\u00e1rio. opencode mcp list<\/b> mostra servidores e status de autoriza\u00e7\u00e3o, opencode mcp logout<\/b> exclui tokens armazenados e opencode mcp debug<\/b> verifica a conectividade de rede e a descoberta OAuth para um servidor espec\u00edfico. Os tokens s\u00e3o armazenados localmente no arquivo ~\/.local\/share\/opencode\/mcp-auth.json<\/b>.<\/p>\n Se o servidor n\u00e3o usar OAuth, mas uma chave de API normal, a autoriza\u00e7\u00e3o autom\u00e1tica dever\u00e1 ser desabilitada, caso contr\u00e1rio, o OpenCode tentar\u00e1 passar o OAuth onde n\u00e3o for necess\u00e1rio:<\/p>\n As ferramentas MCP consomem contexto: cada servidor adiciona descri\u00e7\u00f5es de suas fun\u00e7\u00f5es \u00e0 solicita\u00e7\u00e3o. Portanto, \u00e9 melhor manter desligados os servidores que raramente s\u00e3o necess\u00e1rios. Isso pode ser feito globalmente atrav\u00e9s do bloco tools<\/b>:<\/p>\n O modelo my-mcp*<\/b> desativa todas as ferramentas cujo nome come\u00e7a com este prefixo. Se houver muitos servidores, faz mais sentido desativ\u00e1-los globalmente e ativ\u00e1-los localmente para um agente espec\u00edfico:<\/p>\n A conex\u00e3o com o DeepSeek funciona porque os modelos suportam fun\u00e7\u00f5es de chamada e as ferramentas MCP para eles parecem fun\u00e7\u00f5es comuns. O pr\u00f3prio DeepSeek n\u00e3o conecta servidores MCP e n\u00e3o deveria: a conex\u00e3o \u00e9 controlada pelo OpenCode.<\/p>\n O que voc\u00ea deve prestar aten\u00e7\u00e3o:<\/p>\n Um exemplo de regra para AGENTS.md<\/b>, para que o pr\u00f3prio agente acesse a fonte necess\u00e1ria:<\/p>\n Para o trabalho di\u00e1rio, dois servidores geralmente s\u00e3o suficientes: Context7 para documenta\u00e7\u00e3o e um servidor restrito para uma tarefa espec\u00edfica – por exemplo, Sentry para analisar erros ou Grep para procurar exemplos de c\u00f3digo. \u00c9 melhor manter o resto desligado e lig\u00e1-lo conforme necess\u00e1rio.<\/p>\n Meu procedimento \u00e9 o seguinte: adiciono o servidor em opencode.json<\/b>, reinicio o OpenCode, verifico a lista em opencode mcp list<\/b> e fa\u00e7o uma pergunta de teste que menciona explicitamente o servidor. Se a ferramenta n\u00e3o for chamada, procuro opencode mcp debug<\/b> e o tempo limite – um servidor lento pode n\u00e3o ter tempo para responder nos 30 segundos alocados.<\/p>\n Alguns pontos pr\u00e1ticos. Os servidores MCP s\u00e3o c\u00f3digos confi\u00e1veis: o servidor local \u00e9 executado em sua m\u00e1quina com seus direitos e voc\u00ea envia dados de solicita\u00e7\u00e3o para o remoto. Portanto, a instala\u00e7\u00e3o de servidores aleat\u00f3rios da Internet deve ser feita com o mesmo cuidado que qualquer CLI de terceiros.<\/p>\n Mantenha chaves e tokens em vari\u00e1veis \u200b\u200bde ambiente e n\u00e3o fa\u00e7a commit no reposit\u00f3rio. O OpenCode armazena tokens OAuth localmente, mas em uma m\u00e1quina compartilhada tamb\u00e9m vale a pena considerar isso: opencode mcp logout<\/b> os exclui quando o acesso n\u00e3o \u00e9 mais necess\u00e1rio.<\/p>\n E mais uma coisa: n\u00e3o ligue tudo de uma vez. O MCP acrescenta ferramentas ao contexto, e contexto \u00e9 dinheiro e qualidade de resposta. Dois ou tr\u00eas servidores realmente necess\u00e1rios funcionam muito melhor do que dez conectados, apenas para garantir.<\/p>\n https:\/\/opencode.ai\/docs\/mcp-servers\/<\/a> https:\/\/opencode.ai\/docs\/mcp-servers\/<\/a> MCP (Model Context Protocol) \u00e9 um protocolo aberto que descreve como conectar ferramentas externas e fontes de dados ao modelo de linguagem: um sistema de arquivos, documenta\u00e7\u00e3o, rastreador de tarefas, rastreador de bugs ou seu pr\u00f3prio servi\u00e7o. Em vez de incorporar cada ferramenta ao agente, voc\u00ea configura um servidor MCP separado e o agente se […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[],"class_list":["post-204","post","type-post","status-publish","format-standard","hentry","category-notes"],"translation":{"provider":"WPGlobus","version":"3.0.6","language":"pt","enabled_languages":["en","ru","zh","de","ja","fr","es","pt","hi"],"languages":{"en":{"title":true,"content":true,"excerpt":false},"ru":{"title":true,"content":true,"excerpt":false},"zh":{"title":true,"content":true,"excerpt":false},"de":{"title":true,"content":true,"excerpt":false},"ja":{"title":true,"content":true,"excerpt":false},"fr":{"title":true,"content":true,"excerpt":false},"es":{"title":true,"content":true,"excerpt":false},"pt":{"title":true,"content":true,"excerpt":false},"hi":{"title":true,"content":true,"excerpt":false}}},"_links":{"self":[{"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/posts\/204","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/comments?post=204"}],"version-history":[{"count":0,"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/posts\/204\/revisions"}],"wp:attachment":[{"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/media?parent=204"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/categories?post=204"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/demensdeum.com\/blog\/pt\/wp-json\/wp\/v2\/tags?post=204"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"mcp_everything\": {\n \"type\": \"local\",\n \"command\": [\"npx\", \"-y\", \"@modelcontextprotocol\/server-everything\"]\n }\n }\n}\n<\/code><\/pre>\n<\/div>\n\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 mcp_everything, \u0447\u0442\u043e\u0431\u044b \u0441\u043b\u043e\u0436\u0438\u0442\u044c 3 \u0438 4\n<\/code><\/pre>\n<\/div>\nServidor remoto<\/h2>\n
{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"context7\": {\n \"type\": \"remote\",\n \"url\": \"https:\/\/mcp.context7.com\/mcp\"\n }\n }\n}\n<\/code><\/pre>\n<\/div>\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"context7\": {\n \"type\": \"remote\",\n \"url\": \"https:\/\/mcp.context7.com\/mcp\",\n \"headers\": {\n \"CONTEXT7_API_KEY\": \"{env:CONTEXT7_API_KEY}\"\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"gh_grep\": {\n \"type\": \"remote\",\n \"url\": \"https:\/\/mcp.grep.app\"\n }\n }\n}\n<\/code><\/pre>\n<\/div>\nAutoriza\u00e7\u00e3o via OAuth<\/h2>\n
{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"sentry\": {\n \"type\": \"remote\",\n \"url\": \"https:\/\/mcp.sentry.dev\/mcp\",\n \"oauth\": {}\n }\n }\n}\n<\/code><\/pre>\n<\/div>\nopencode mcp auth sentry\n<\/code><\/pre>\n<\/div>\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"my-api-key-server\": {\n \"type\": \"remote\",\n \"url\": \"https:\/\/mcp.example.com\/mcp\",\n \"oauth\": false,\n \"headers\": {\n \"Authorization\": \"Bearer {env:MY_API_KEY}\"\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\nGerenciamento de ferramentas<\/h2>\n
{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"my-mcp-foo\": {\n \"type\": \"local\",\n \"command\": [\"npx\", \"-y\", \"my-mcp-command-foo\"]\n },\n \"my-mcp-bar\": {\n \"type\": \"local\",\n \"command\": [\"npx\", \"-y\", \"my-mcp-command-bar\"]\n }\n },\n \"tools\": {\n \"my-mcp*\": false\n }\n}\n<\/code><\/pre>\n<\/div>\n{\n \"$schema\": \"https:\/\/opencode.ai\/config.json\",\n \"mcp\": {\n \"my-mcp\": {\n \"type\": \"local\",\n \"command\": [\"npx\", \"-y\", \"my-mcp-command\"],\n \"enabled\": true\n }\n },\n \"tools\": {\n \"my-mcp*\": false\n },\n \"agent\": {\n \"my-agent\": {\n \"tools\": {\n \"my-mcp*\": true\n }\n }\n }\n}\n<\/code><\/pre>\n<\/div>\nRecursos do DeepSeek<\/h2>\n
\n
\u041a\u043e\u0433\u0434\u0430 \u043d\u0443\u0436\u043d\u043e \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b context7.\n<\/code><\/pre>\n<\/div>\nReceita pr\u00e1tica<\/h2>\n
No que prestar aten\u00e7\u00e3o<\/h2>\n
Links<\/h2>\n
\nhttps:\/\/opencode.ai\/docs\/config\/<\/a>
\nhttps:\/\/modelcontextprotocol.io\/<\/a>
\nhttps:\/\/github.com\/upstash\/context7<\/a>
\nhttps:\/\/mcp.sentry.dev<\/a>
\nhttps:\/\/mcp.grep.app<\/a>
\nhttps:\/\/github.com\/anomalyco\/opencode<\/a><\/p>\nFontes<\/h2>\n
\nhttps:\/\/modelcontextprotocol.io\/<\/a>
\nhttps:\/\/api-docs.deepseek.com\/<\/a>
\nhttps:\/\/api-docs.deepseek.com\/quick_start\/agent_integrations\/opencode<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"