mcp-opencode
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-opencode Run the bug fix task and show the resulting diff"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-opencode
MCP local de 25 herramientas para que Codex/ChatGPT coordine OpenCode y sus agentes configurados.
Capacidades
opencode_setup: salud, agentes, proveedores, proyecto, Git y sesiones.opencode_context: contexto agregado para planear: proyectos, agentes, modelos, sesiones, comandos, MCP y archivos.opencode_agents: agentes disponibles.opencode_projects/opencode_sessions: descubrimiento y continuidad de trabajo.opencode_providers/opencode_commands/opencode_mcp_status: capacidades disponibles.opencode_permissions/opencode_respond_permission: control explícito de pausas headless de OpenCode.opencode_run: tarea síncrona con respuesta y diff.opencode_reply: continuidad de una sesión existente.opencode_fire: tarea asíncrona para paralelización.opencode_parallel: fan-out controlado de hasta 12 tareas, con rechazo de escrituras concurrentes en el mismo directorio.opencode_check/opencode_wait/opencode_wait_many: seguimiento de sesiones.opencode_children/opencode_messages: auditoría de subagentes y continuidad.opencode_fork/opencode_summarize: bifurcación y compactación de sesiones largas.opencode_review: diff y estado de archivos.opencode_file_status: estado de archivos antes/después.opencode_abort: detención explícita de una sesión.
El servidor mantiene una interfaz de coordinación de alto nivel para el modelo y deja que OpenCode aplique sus propios permisos, agentes, herramientas MCP, AGENTS.md, modelos y subagentes.
Los listados de agentes se entregan compactados: conservan nombre, rol, modo, modelo, vista previa del prompt y resumen de permisos sin inyectar cientos de kilobytes de configuración en el contexto del modelo. Los modelos se seleccionan con provider/model, por ejemplo opencode-go/deepseek-v4-pro.
Las tareas, sesiones y operaciones de escritura requieren una ruta directory explícita para no modificar accidentalmente el propio MCP. Puedes definir OPENCODE_DEFAULT_DIRECTORY si quieres un proyecto predeterminado controlado.
Related MCP server: local-agent-mcp
Desarrollo
npm install
npm run check
npm run smoke
npm run runtime-smoke
npm start
npm run setup-startupConfiguración
Por defecto intenta iniciar OpenCode mediante el SDK oficial. Para conectarlo a un servidor ya iniciado:
$env:OPENCODE_BASE_URL = "http://127.0.0.1:4096"
$env:OPENCODE_AUTO_SERVE = "false"Variables disponibles:
OPENCODE_BASE_URLOPENCODE_SERVER_USERNAMEOPENCODE_SERVER_PASSWORDOPENCODE_AUTO_SERVE(por defectotrue)OPENCODE_DEFAULT_AGENT(por defectochatgpt-coordinator)OPENCODE_DEFAULT_MODELOPENCODE_DEFAULT_DIRECTORY(opcional; debe ser una carpeta de proyecto existente)
Registro en Codex Desktop
Después de compilar, una entrada global típica en C:\Users\TU_USUARIO\.codex\config.toml es:
[mcp_servers.opencode]
command = "node"
args = ["C:\\Users\\TU_USUARIO\\Documents\\Programming-personal\\mcp-opencode\\dist\\index.js"]
cwd = "C:\\Users\\TU_USUARIO\\Documents\\Programming-personal\\mcp-opencode"
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 900
default_tools_approval_mode = "prompt"Reinicia Codex Desktop y verifica /mcp. No se deben registrar secretos en este archivo.
Inicio automático de Windows
Este MCP usa STDIO, así que Codex debe ser su cliente y proceso supervisor. Para que quede disponible al iniciar sesión de Windows, ejecuta desde la raíz:
npm run setup-startupEl comando registra una tarea idempotente que resuelve la instalación actual y abre Codex Desktop al iniciar sesión; así sobrevive a actualizaciones de WindowsApps. Codex carga entonces la entrada mcp_servers.opencode y lanza el MCP cuando corresponda. No se deja un proceso STDIO huérfano sin cliente. Para quitarlo:
npm run remove-startupPolítica de coordinación
El servidor entrega instrucciones MCP para que el modelo:
consulte el contexto antes de delegar;
use
opencode_runpara tareas bloqueantes;use
opencode_firesolo para trabajos independientes;nunca permita escrituras concurrentes sobre los mismos archivos;
consulte diff y pruebas antes de informar éxito.
Paralelización
opencode_parallel exige un directorio por tarea. Por defecto rechaza varias tareas con intención de escritura en el mismo directorio, porque las sesiones OpenCode comparten el árbol de archivos. Para cambios paralelos usa worktrees o carpetas distintas; allowSharedDirectory solo debe activarse cuando el usuario confirme que no habrá solapamiento.
Available Tools
25 toolsopencode_abortDetener sesión OpenCodeA
Detiene una sesión en ejecución. Úsalo solo cuando el usuario lo solicite o exista un bloqueo claro.
Inputs: directory (required), sessionId (required).
opencode_agentsListar agentes OpenCodeA
Devuelve los agentes primarios y subagentes disponibles, sus modelos y modos.
Inputs: directory.
opencode_checkConsultar progreso OpenCodeA
Devuelve estado, TODO, diff y mensajes recientes de una sesión.
Inputs: directory (required), sessionId (required).
opencode_childrenVer subagentes de una sesiónA
Devuelve las sesiones hijas creadas por OpenCode mediante Task, útil para auditar la delegación interna.
Inputs: directory (required), sessionId (required).
opencode_commandsListar comandos OpenCodeA
Lista comandos y workflows definidos globalmente o por el proyecto.
Inputs: directory.
opencode_contextContexto completo OpenCodeA
Agrega proyecto, agentes, proveedores, sesiones, comandos, MCP y estado de archivos para que ChatGPT pueda planear correctamente.
Inputs: directory.
opencode_file_statusEstado de archivos del proyectoA
Obtiene el estado de archivos que OpenCode ve en el proyecto para comprobar cambios antes y después de una tarea.
Inputs: directory (required).
opencode_fireLanzar tarea OpenCode en segundo planoA
Crea una sesión y dispara una tarea sin esperar. Úsalo para tareas independientes; devuelve un sessionId para seguimiento.
Inputs: prompt (required), directory (required), agent, model, +2 more.
opencode_forkBifurcar sesión OpenCodeA
Crea una sesión hija desde una sesión existente para explorar una alternativa sin perder el contexto original.
Inputs: directory (required), sessionId (required), title, messageId.
opencode_mcp_statusEstado MCP interno de OpenCodeA
Consulta los MCP que OpenCode tiene conectados y sus estados sin modificar configuración.
Inputs: directory.
opencode_messagesLeer mensajes de una sesiónA
Devuelve mensajes recientes de una sesión para continuidad, diagnóstico y evidencia.
Inputs: directory (required), sessionId (required), limit.
opencode_parallelCoordinar tareas OpenCode en paraleloA
Despacha hasta 12 tareas independientes. Rechaza por defecto escrituras concurrentes en el mismo directorio; usa worktrees/directorios distintos o permite la excepción explícitamente.
Inputs: tasks (required), allowSharedDirectory.
opencode_permissionsPermisos pendientes OpenCodeA
Consulta solicitudes de permiso pendientes y eventos recientes para resolver pausas de una sesión headless.
Inputs: directory.
opencode_projectsListar proyectos OpenCodeA
Lista los proyectos que OpenCode conoce. Úsalo para orientar una tarea cuando no se tenga claro el directorio.
Inputs: directory.
opencode_providersConsultar modelos OpenCodeA
Lista proveedores y modelos disponibles, incluido OpenCode Go, para seleccionar Flash o Pro con evidencia.
Inputs: directory.
opencode_replyContinuar sesión OpenCodeA
Envía una nueva instrucción a una sesión existente y devuelve respuesta, estado y diff actualizado.
Inputs: prompt (required), directory (required), sessionId (required), agent, +1 more.
opencode_respond_permissionResponder permiso OpenCodeB
Responde una solicitud headless con once, always o reject. Úsalo solo después de revisar el título y patrón del permiso.
Inputs: response (required), directory (required), sessionId (required), permissionId (required).
opencode_reviewRevisar cambios OpenCodeA
Obtiene la sesión, diff y estado de archivos para revisar el resultado antes de aceptarlo.
Inputs: directory (required), sessionId (required).
opencode_runEjecutar tarea OpenCodeA
Crea una sesión, delega una tarea al agente elegido, espera su respuesta y devuelve evidencia incluyendo diff.
Inputs: prompt (required), directory (required), agent, model, +2 more.
opencode_sessionsListar sesiones OpenCodeA
Lista sesiones recientes del proyecto, útil para retomar trabajo o auditar tareas en segundo plano.
Inputs: limit, directory.
opencode_setupPreparar contexto OpenCodeA
Comprueba salud, agentes, proveedores, proyecto, Git y sesiones activas. Úsalo antes de delegar una tarea nueva.
Inputs: directory.
opencode_statusEstado OpenCodeB
Consulta salud, sesiones ocupadas, MCP de OpenCode y estado Git del proyecto.
Inputs: directory.
opencode_summarizeCompactar sesión OpenCodeA
Resume/compacta una sesión larga usando un modelo explícito para conservar continuidad y liberar contexto.
Inputs: model (required), directory (required), sessionId (required).
opencode_waitEsperar tarea OpenCodeA
Espera una sesión asíncrona hasta que termine o alcance el tiempo límite y devuelve su evidencia.
Inputs: directory (required), sessionId (required), pollIntervalMs, timeoutSeconds.
opencode_wait_manyEsperar varias tareas OpenCodeA
Espera en paralelo varias sesiones previamente despachadas y devuelve el resultado de cada una.
Inputs: sessions (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Many tools have overlapping purposes, especially status/check/review which all inspect sessions and diffs. However, descriptions attempt to differentiate in specific ways, and the rest are more distinct.
All tools share the consistent 'opencode_' prefix, but the suffix mixes verbs (run, fire, wait) and nouns (sessions, projects) without a strict verb_noun pattern. Still, the pattern is predictable and readable.
At 25 tools, the server is on the heavy side for its scope. Several tools could likely be consolidated (e.g., status-like queries), but the count is not unreasonable for a full-featured session manager.
The tool set covers session lifecycle well: create, run, reply, fork, wait, abort, and monitor. Gaps include no explicit session deletion or update of provider configurations, but core workflows are present.
Related MCP Connectors
Shared control plane for AI coding agents — tasks, memory, decisions, file locks. 12 tools.
Command center for developers coordinating AI coding agents across projects.
Multiplayer for the coding agents your team already uses: shared tasks, decisions, skills and tools.
Coordination hub for AI coding agents: message teammates, ask humans, audit every event.
Related MCP Servers
- AlicenseAqualityDmaintenanceA project-local MCP bridge that allows Codex Desktop to plan tasks and OpenCode to execute them within the current project directory, with session reuse and native OpenCode background subagents.41MIT
- AlicenseBqualityCmaintenanceEnables ChatGPT to work directly on local projects by reading files, editing code, running tests and commands, inspecting Git state, and managing durable workflows, with optional delegation to local Codex agents for complex tasks.28MIT
- AlicenseAqualityDmaintenanceEnables Codex to delegate coding tasks to an OpenCode CLI locally, returning structured results such as exit codes, session summaries, tool calls, and git diffs.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT conversations to directly inspect local workspaces and delegate coding tasks to a local Codex agent, with controlled concurrency, reusable sessions, and task/usage tracking.MIT