Configura el servidor MCP de DevSpeak

El servidor MCP de DevSpeak da a los clientes de IA compatibles acceso directo a las herramientas de traducción de producción de DevSpeak.

Hoy DevSpeak admite dos transportes MCP:

stdio local mediante el paquete npm publicado @devspeak/mcp

streamable-http alojado mediante https://www.devspeak.dev/mcp

Qué expone el servidor MCP

Una vez configurado, los usuarios pueden acceder a doce herramientas:

translate_text

translate_markdown

refine_translation

optimize_text

summarize_input

get_history

get_account_info

detect_language

list_languages

auth_confirm

patch_translation_note

publish_linkedin_post: solo administradores; genera una previsualización por defecto y publica únicamente cuando dryRun es explícitamente false

El servidor también expone recursos de solo lectura para idiomas soportados, referencia de API y referencia del flujo de trabajo.

Estas herramientas se ejecutan sobre la API en vivo de DevSpeak, por lo que no necesitas un backend local separado.

Requisitos

Necesitarás:

Una clave API de DevSpeak

Node.js para instalaciones locales con stdio, o un cliente compatible con MCP remoto para el endpoint alojado

Un cliente compatible con MCP, como Claude Code, Claude Desktop, Cursor, Gemini CLI, Antigravity u otro host similar

Configuración local recomendada: Claude Code

Añade el servidor a ~/.claude/settings.json (nivel de usuario) o .claude/settings.json (nivel de proyecto):

``json

{


  "mcpServers": {
    "devspeak": {
      "command": "npx",
      "args": ["-y", "-p", "@devspeak/mcp", "devspeak-mcp"],
      "env": {
        "DEVSPEAK_API_KEY": "dsk_live_your_key_here"
      }
    }
  }
}

`Ejemplo para Claude Desktop`

Añade la siguiente entrada al archivo de configuración de Claude Desktop.

`json


{
  "mcpServers": {
    "devspeak": {
      "command": "npx",
      "args": ["-y", "-p", "@devspeak/mcp", "devspeak-mcp"],
      "env": {
        "DEVSPEAK_API_KEY": "dsk_live_your_key_here"
      }
    }
  }
}

Ubicaciones habituales del archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

`Ejemplo para Cursor`

En Cursor, añade un servidor MCP basado en comandos con:

Comando: npx

Argumentos: -y -p @devspeak/mcp devspeak-mcp

Variable de entorno: DEVSPEAK_API_KEY=dsk_live_your_key_here

`Endpoint alojado para clientes remotos`

Si tu host MCP soporta streamable-http, apúntalo a:

Endpoint: https://www.devspeak.dev/mcp

Cabecera de autenticación: x-api-key: dsk_live_your_key_here

Usa el host www. El dominio raíz devspeak.dev responde con una redirección 308, y varios clientes MCP no siguen redirecciones en peticiones POST de streamable-http.

Los clientes que solo aceptan autenticación tipo bearer pueden enviar Authorization: Bearer ; el servidor normaliza esa cabecera a x-api-key antes de las comprobaciones de autenticación.

Gemini CLI, Antigravity y otros hosts remotos deben usar el transporte que mejor encaje con su modelo de configuración MCP: el paquete npm local para stdio, o el endpoint alojado anterior para sesiones remotas.

`Verificar la conexión`

Después de reiniciar el cliente, prueba la configuración pidiéndole al agente que ejecute:

auth_confirm

list_languages

Si la clave es válida, el agente debería confirmar que puede llegar al backend de DevSpeak.

`Combinar MCP con los skills de DevSpeak`

El servidor MCP aporta las herramientas. Los skills públicos de DevSpeak aportan las instrucciones del flujo de trabajo. En la práctica, la mayoría de usuarios debería instalar ambos:

`bash

npx skills add devspeak-dev/devspeak-skills

Esa combinación le da al agente tanto acceso en tiempo de ejecución como guía específica de tareas.

`Superficies públicas de descubrimiento`

Los puntos públicos actuales para descubrir el servidor MCP son:

MCP Registry oficial: io.github.juanjaragavi/devspeak

mcp.so: https://mcp.so/server/devspeak

Smithery Connect: juanamillo-1duz/devspeak`