Conexión de agentes MCP

Esta guía cubre los clientes que Kodavio expone en Connect: Codex, Claude, OpenCode, Cursor y Windsurf.

Base común para cualquier agente

1. En WordPress abre Usuarios > Perfil > Application Passwords (contraseñas de aplicación).
2. Crea una clave con nombre reconocible (ejemplo: Kodavio MCP - Codex local).
3. Copia la clave al momento (WordPress solo la muestra una vez).
4. Usa la ruta preferida de Kodavio:

/wp-json/mcp/kodavio

5. Reinicia o recarga el cliente MCP después de configurar el servidor.

Codex (recomendado para la beta)

Comando:

codex mcp add kodavio_dev \
  --env WP_API_URL='https://TU-DOMINIO/wp-json/mcp/kodavio' \
  --env OAUTH_ENABLED='false' \
  --env WP_API_USERNAME='TU_USUARIO_WP' \
  --env WP_API_PASSWORD='TU_APPLICATION_PASSWORD' \
  -- npx -y @automattic/mcp-wordpress-remote@0.3.1

Bloque equivalente en ~/.codex/config.toml:

[mcp_servers.kodavio_dev]
command = "npx"
args = ["-y", "@automattic/mcp-wordpress-remote@0.3.1"]

[mcp_servers.kodavio_dev.env]
OAUTH_ENABLED = "false"
WP_API_URL = "https://TU-DOMINIO/wp-json/mcp/kodavio"
WP_API_USERNAME = "TU_USUARIO_WP"
WP_API_PASSWORD = "TU_APPLICATION_PASSWORD"

Claude

Comando CLI:

claude mcp add 'kodavio_dev' \
  --env WP_API_URL='https://TU-DOMINIO/wp-json/mcp/kodavio' \
  --env OAUTH_ENABLED='false' \
  --env WP_API_USERNAME='TU_USUARIO_WP' \
  --env WP_API_PASSWORD='TU_APPLICATION_PASSWORD' \
  -- npx -y @automattic/mcp-wordpress-remote@0.3.1

Alternativa en ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kodavio_dev": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@0.3.1"],
      "env": {
        "WP_API_URL": "https://TU-DOMINIO/wp-json/mcp/kodavio",
        "OAUTH_ENABLED": "false",
        "WP_API_USERNAME": "TU_USUARIO_WP",
        "WP_API_PASSWORD": "TU_APPLICATION_PASSWORD"
      }
    }
  }
}

OpenCode

Archivo sugerido: ~/.config/opencode/opencode.json

{
  "mcp": {
    "kodavio_dev": {
      "type": "local",
      "command": ["npx", "-y", "@automattic/mcp-wordpress-remote@0.3.1"],
      "environment": {
        "WP_API_URL": "https://TU-DOMINIO/wp-json/mcp/kodavio",
        "OAUTH_ENABLED": "false",
        "WP_API_USERNAME": "TU_USUARIO_WP",
        "WP_API_PASSWORD": "TU_APPLICATION_PASSWORD"
      }
    }
  }
}

Cursor

Archivo sugerido: ~/.cursor/mcp.json

{
  "mcpServers": {
    "kodavio_dev": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@0.3.1"],
      "env": {
        "WP_API_URL": "https://TU-DOMINIO/wp-json/mcp/kodavio",
        "OAUTH_ENABLED": "false",
        "WP_API_USERNAME": "TU_USUARIO_WP",
        "WP_API_PASSWORD": "TU_APPLICATION_PASSWORD"
      }
    }
  }
}

Windsurf

Archivo sugerido: ~/.codeium/windsurf/mcp.json

{
  "mcpServers": {
    "kodavio_dev": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@0.3.1"],
      "env": {
        "WP_API_URL": "https://TU-DOMINIO/wp-json/mcp/kodavio",
        "OAUTH_ENABLED": "false",
        "WP_API_USERNAME": "TU_USUARIO_WP",
        "WP_API_PASSWORD": "TU_APPLICATION_PASSWORD"
      }
    }
  }
}

Cliente MCP genérico

Si tu cliente no aparece en esta guía, usa este bloque JSON base:

{
  "mcpServers": {
    "kodavio_dev": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@0.3.1"],
      "env": {
        "WP_API_URL": "https://TU-DOMINIO/wp-json/mcp/kodavio",
        "OAUTH_ENABLED": "false",
        "WP_API_USERNAME": "TU_USUARIO_WP",
        "WP_API_PASSWORD": "TU_APPLICATION_PASSWORD"
      }
    }
  }
}

Validación mínima tras conectar

En Kodavio > Connect > Estado MCP, ejecuta Preflight MCP.

Debe validar:

• inicio MCP (initialize)
• listado de herramientas (tools/list)
• ruta resuelta
• clase de error accionable si hay fallo (auth, route_404, timeout, waf, capability_missing)

Luego, en el agente, pide una comprobación de solo lectura:

Usa el servidor MCP de Kodavio de este sitio.

Haz solo lectura:
- confirma conexión MCP;
- lista las capacidades públicas disponibles;
- resume los constructores detectados;
- lee `kodavio/design-get-system` y `kodavio/builder-get-config`;
- confirma si hay herramientas sensibles desactivadas.

No hagas cambios.

Varios sitios y varios MCP

• Crea un servidor por entorno: cliente_prod, cliente_staging, cliente_dev.
• Si usas otro MCP de WordPress (ejemplo JetEngine/Crocoblock), configúralo como servidor independiente.
• No mezcles rutas MCP distintas dentro de una sola entrada.