--- title: MCP servidores description: Agregue herramientas MCP locales y remotas. --- Puede agregar herramientas externas a OpenCode utilizando el _Model Context Protocol_ o MCP. OpenCode admite servidores locales y remotos. Una vez agregadas, las herramientas MCP están disponibles automáticamente para LLM junto con las herramientas integradas. --- #### Advertencias Cuando utiliza un servidor MCP, se suma al contexto. Esto puede acumularse rápidamente si tiene muchas herramientas. Por lo que recomendamos tener cuidado con qué servidores MCP utiliza. :::tip Los servidores MCP se agregan a su contexto, por lo que debe tener cuidado con cuáles habilita. ::: Ciertos servidores MCP, como el servidor GitHub MCP, tienden a agregar muchos tokens y pueden exceder fácilmente el límite de contexto. --- ## Permitir Puede definir servidores MCP en su [OpenCode Config](https://opencode.ai/docs/config/) en `mcp`. Agregue cada MCP con un nombre único. Puede referirse a ese MCP por su nombre cuando solicite el LLM. ```jsonc title="opencode.jsonc" {6} { "$schema": "https://opencode.ai/config.json", "mcp": { "name-of-mcp-server": { // ... "enabled": true, }, "name-of-other-mcp-server": { // ... }, }, } ``` También puede desactivar un servidor configurando `enabled` en `false`. Esto es útil si desea desactivar temporalmente un servidor sin eliminarlo de su configuración. --- ### Anulación de los valores predeterminados remotos Las organizaciones pueden proporcionar servidores MCP predeterminados a través de su punto final `.well-known/opencode`. Estos servidores pueden estar deshabilitados de forma predeterminada, lo que permite a los usuarios optar por los que necesitan. Para habilitar un servidor específico desde la configuración remota de su organización, agréguelo a su configuración local con `enabled: true`: ```json title="opencode.json" { "$schema": "https://opencode.ai/config.json", "mcp": { "jira": { "type": "remote", "url": "https://jira.example.com/mcp", "enabled": true } } } ``` Los valores de configuración local anulan los valores predeterminados remotos. Consulte [precedencia de configuración](/docs/config#precedence-order) para obtener más detalles. --- ## Local Agregue servidores MCP locales usando `type` a `"local"` dentro del objeto MCP. ```jsonc title="opencode.jsonc" {15} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-local-mcp-server": { "type": "local", // Or ["bun", "x", "my-mcp-command"] "command": ["npx", "-y", "my-mcp-command"], "enabled": true, "environment": { "MY_ENV_VAR": "my_env_var_value", }, }, }, } ``` El comando es cómo se inicia el servidor MCP local. También puede pasar una lista de variables de entorno. Por ejemplo, así es como puede agregar el servidor de prueba [`@modelcontextprotocol/server-everything`](https://www.npmjs.com/package/@modelcontextprotocol/server-everything) MCP. ```jsonc title="opencode.jsonc" { "$schema": "https://opencode.ai/config.json", "mcp": { "mcp_everything": { "type": "local", "command": ["npx", "-y", "@modelcontextprotocol/server-everything"], }, }, } ``` Y para usarlo puedo agregar `use the mcp_everything tool` a mis indicaciones. ```txt "mcp_everything" use the mcp_everything tool to add the number 3 and 4 ``` --- #### Opciones Aquí están todas las opciones para configurar un servidor MCP local. | Opción | Tipo | Requerido | Descripción | | ------------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------ | | `type` | Cadena | Y | El tipo de conexión del servidor MCP debe ser `"local"`. | | `command` | Matriz | Y | Comando y argumentos para ejecutar el servidor MCP. | | `environment` | Objeto | | Variables de entorno para configurar al ejecutar el servidor. | | `enabled` | booleano | | Habilite o deshabilite el servidor MCP al inicio. | | `timeout` | Número | | Tiempo de espera en ms para recuperar herramientas del servidor MCP. El valor predeterminado es 5000 (5 segundos). | --- ## Remoto Agregue servidores MCP remotos configurando `type` en `"remote"`. ```json title="opencode.json" { "$schema": "https://opencode.ai/config.json", "mcp": { "my-remote-mcp": { "type": "remote", "url": "https://my-mcp-server.com", "enabled": true, "headers": { "Authorization": "Bearer MY_API_KEY" } } } } ``` `url` es la URL del servidor MCP remoto y con la opción `headers` puede pasar una lista de encabezados. --- #### Opciones | Opción | Tipo | Requerido | Descripción | | --------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------ | | `type` | Cadena | Y | El tipo de conexión del servidor MCP debe ser `"remote"`. | | `url` | Cadena | Y | URL del servidor MCP remoto. | | `enabled` | booleano | | Habilite o deshabilite el servidor MCP al inicio. | | `headers` | Objeto | | Encabezados para enviar con la solicitud. | | `oauth` | Objeto | | OAuth configuración de autenticación. Consulte la sección [OAuth](#oauth) a continuación. | | `timeout` | Número | | Tiempo de espera en ms para recuperar herramientas del servidor MCP. El valor predeterminado es 5000 (5 segundos). | --- ## OAuth OpenCode maneja automáticamente la autenticación OAuth para servidores MCP remotos. Cuando un servidor requiere autenticación, OpenCode: 1. Detectar la respuesta 401 e iniciar el flujo OAuth 2. Utilice **Registro dinámico de cliente (RFC 7591)** si el servidor lo admite. 3. Almacene tokens de forma segura para futuras solicitudes --- ### Automático Para la mayoría de los servidores MCP habilitados para OAuth, no se necesita ninguna configuración especial. Simplemente configure el servidor remoto: ```json title="opencode.json" { "$schema": "https://opencode.ai/config.json", "mcp": { "my-oauth-server": { "type": "remote", "url": "https://mcp.example.com/mcp" } } } ``` Si el servidor requiere autenticación, OpenCode le pedirá que se autentique cuando intente usarlo por primera vez. De lo contrario, puede [activar manualmente el flujo](#authenticating) con `opencode mcp auth `. --- ### Preinscrito Si tiene credenciales de cliente del proveedor del servidor MCP, puede configurarlas: ```json title="opencode.json" {7-11} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-oauth-server": { "type": "remote", "url": "https://mcp.example.com/mcp", "oauth": { "clientId": "{env:MY_MCP_CLIENT_ID}", "clientSecret": "{env:MY_MCP_CLIENT_SECRET}", "scope": "tools:read tools:execute" } } } } ``` --- ### Autenticación Puede activar manualmente la autenticación o administrar las credenciales. Autenticar con un servidor MCP específico: ```bash opencode mcp auth my-oauth-server ``` Enumere todos los servidores MCP y su estado de autenticación: ```bash opencode mcp list ``` Eliminar las credenciales almacenadas: ```bash opencode mcp logout my-oauth-server ``` El comando `mcp auth` abrirá su navegador para obtener autorización. Después de su autorización, OpenCode almacenará los tokens de forma segura en `~/.local/share/opencode/mcp-auth.json`. --- #### Deshabilitando OAuth Si desea deshabilitar el OAuth automático para un servidor (por ejemplo, para servidores que usan claves API), configure `oauth` en `false`: ```json title="opencode.json" {7} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-api-key-server": { "type": "remote", "url": "https://mcp.example.com/mcp", "oauth": false, "headers": { "Authorization": "Bearer {env:MY_API_KEY}" } } } } ``` --- #### OAuth Opciones | Opción | Tipo | Descripción | | -------------- | --------------- | -------------------------------------------------------------------------------------------- | | `oauth` | Objeto \| falso | OAuth objeto de configuración, o `false` para deshabilitar la detección automática de OAuth. | | `clientId` | Cadena | OAuth ID de cliente. Si no se proporciona, se intentará el registro dinámico del cliente. | | `clientSecret` | Cadena | OAuth secreto del cliente, si lo requiere el servidor de autorización. | | `scope` | Cadena | OAuth alcances para solicitar durante la autorización. | #### Depuración Si un servidor MCP remoto no puede autenticarse, puede diagnosticar problemas con: ```bash # View auth status for all OAuth-capable servers opencode mcp auth list # Debug connection and OAuth flow for a specific server opencode mcp debug my-oauth-server ``` El comando `mcp debug` muestra el estado de autenticación actual, prueba la conectividad HTTP e intenta el flujo de descubrimiento OAuth. --- ## Administrar Sus MCP están disponibles como herramientas en OpenCode, junto con herramientas integradas. Para que puedas administrarlos a través de la configuración OpenCode como cualquier otra herramienta. --- ### Global Esto significa que puede habilitarlos o deshabilitarlos globalmente. ```json title="opencode.json" {14} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-mcp-foo": { "type": "local", "command": ["bun", "x", "my-mcp-command-foo"] }, "my-mcp-bar": { "type": "local", "command": ["bun", "x", "my-mcp-command-bar"] } }, "tools": { "my-mcp-foo": false } } ``` También podemos usar un patrón global para deshabilitar todos los MCP coincidentes. ```json title="opencode.json" {14} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-mcp-foo": { "type": "local", "command": ["bun", "x", "my-mcp-command-foo"] }, "my-mcp-bar": { "type": "local", "command": ["bun", "x", "my-mcp-command-bar"] } }, "tools": { "my-mcp*": false } } ``` Aquí estamos usando el patrón global `my-mcp*` para deshabilitar todos los MCP. --- ### Por agente Si tiene una gran cantidad de servidores MCP, es posible que desee habilitarlos solo por agente y deshabilitarlos globalmente. Para hacer esto: 1. Desactívelo como herramienta a nivel global. 2. En su [configuración del agente](/docs/agents#tools), habilite el servidor MCP como herramienta. ```json title="opencode.json" {11, 14-18} { "$schema": "https://opencode.ai/config.json", "mcp": { "my-mcp": { "type": "local", "command": ["bun", "x", "my-mcp-command"], "enabled": true } }, "tools": { "my-mcp*": false }, "agent": { "my-agent": { "tools": { "my-mcp*": true } } } } ``` --- #### Patrones globales El patrón global utiliza patrones globales simples de expresiones regulares: - `*` coincide con cero o más de cualquier carácter (por ejemplo, `"my-mcp*"` coincide con `my-mcp_search`, `my-mcp_list`, etc.) - `?` coincide exactamente con un carácter - Todos los demás caracteres coinciden literalmente :::note Las herramientas del servidor MCP están registradas con el nombre del servidor como prefijo, por lo que para deshabilitar todas las herramientas para un servidor simplemente use: ``` "mymcpservername_*": false ``` ::: --- ## Ejemplos A continuación se muestran ejemplos de algunos servidores MCP comunes. Puede enviar un PR si desea documentar otros servidores. --- ### centinela Agregue el [servidor Sentry MCP](https://mcp.sentry.dev) para interactuar con sus proyectos y problemas Sentry. ```json title="opencode.json" {4-8} { "$schema": "https://opencode.ai/config.json", "mcp": { "sentry": { "type": "remote", "url": "https://mcp.sentry.dev/mcp", "oauth": {} } } } ``` Después de agregar la configuración, autentíquese con Sentry: ```bash opencode mcp auth sentry ``` Esto abrirá una ventana del navegador para completar el flujo OAuth y conectar OpenCode a su cuenta Sentry. Una vez autenticado, puede utilizar las herramientas Sentry en sus indicaciones para consultar problemas, proyectos y datos de errores. ```txt "use sentry" Show me the latest unresolved issues in my project. use sentry ``` --- ### Contexto7 Agregue el [servidor Context7 MCP](https://github.com/upstash/context7) para buscar en los documentos. ```json title="opencode.json" {4-7} { "$schema": "https://opencode.ai/config.json", "mcp": { "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp" } } } ``` Si se ha registrado para obtener una cuenta gratuita, puede usar su clave API y obtener límites de tarifas más altos. ```json title="opencode.json" {7-9} { "$schema": "https://opencode.ai/config.json", "mcp": { "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp", "headers": { "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}" } } } } ``` Aquí asumimos que tiene configurada la variable de entorno `CONTEXT7_API_KEY`. Agregue `use context7` a sus indicaciones para usar el servidor Context7 MCP. ```txt "use context7" Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7 ``` Alternativamente, puede agregar algo como esto a su [AGENTS.md](/docs/rules/). ```md title="AGENTS.md" When you need to search docs, use `context7` tools. ``` --- ### Grep de Vercel Agregue el servidor [Grep by Vercel](https://grep.app) MCP para buscar fragmentos de código en GitHub. ```json title="opencode.json" {4-7} { "$schema": "https://opencode.ai/config.json", "mcp": { "gh_grep": { "type": "remote", "url": "https://mcp.grep.app" } } } ``` Dado que llamamos a nuestro servidor MCP `gh_grep`, puede agregar `use the gh_grep tool` a sus indicaciones para que el agente lo use. ```txt "use the gh_grep tool" What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool ``` Alternativamente, puede agregar algo como esto a su [AGENTS.md](/docs/rules/). ```md title="AGENTS.md" If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. ```