Tutorial de configuración del servidor MCP @devspeak/mcp: generar una clave de API (en cualquier plan), agregar el bloque stdio en settings.json de Claude Code, claude_desktop_config.json de Claude Desktop, .cursor/mcp.json de Cursor y mcp_config.json de Windsurf, verificar con auth_confirm, leer tier y cuotas con get_account_info, y resolver fallos: sin herramientas de DevSpeak (JSON inválido o sin reiniciar), Cannot reach the DevSpeak API (proxy o VPN), HTTP 401 (clave incorrecta, revocada o sin sustituir) y HTTP 403 (tier sin acceso a la API).
Conecta el Servidor MCP de DevSpeak a tu IDE con IA
El servidor MCP de DevSpeak expone el motor de traducción como herramientas que tu asistente de IA puede invocar directamente. En lugar de copiar texto a un navegador, le pides al asistente que convierta una nota informal en una especificación técnica y ocurre ahí mismo.
Este tutorial te lleva desde cero hasta una conexión verificada.
Lo que Aprenderás
auth_confirmget_account_infoRequisitos Previos
Tiempo Estimado
~9 minutos
Paso 1 — Genera una Clave de API
Abre Ajustes de la Cuenta → Credenciales en el panel de DevSpeak (o haz clic en Claves API en la barra lateral) y crea una clave en la sección Claves API. Se ve así:
`` dsk_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6text
`
La clave completa se muestra una sola vez. Cópiala ahora.
Las claves llevan un prefijo que indica a qué entorno pertenecen:
| Prefijo | Entorno |
| ----------- | --------------------- |
| dsk_live_ | Producción |
| dsk_test_ | Solo desarrollo local |
Todos los planes pueden crear una clave de API. GRATIS y VIBECODER incluyen una clave y 50 solicitudes a la API por mes calendario con el modelo predeterminado de DevSpeak, suficiente para conectar el servidor y probarlo; DEVELOPER y superiores no tienen límite mensual de solicitudes y pueden fijar cualquier modelo.
Paso 2 — Registra el Servidor
Elige el bloque de tu cliente. Todos ejecutan el mismo servidor sobre stdio.
Claude Code
Agrega a ~/.claude/settings.json:
`json
{
"mcpServers": {
"devspeak": {
"command": "npx",
"args": ["-y", "-p", "@devspeak/mcp", "devspeak-mcp"],
"env": {
"DEVSPEAK_API_KEY": "dsk_live_TU_CLAVE_AQUI"
}
}
}
}
`Claude Desktop
Edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS, o %APPDATA%\Claude\claude_desktop_config.json en Windows. El bloque es idéntico al de Claude Code.Cursor
Crea .cursor/mcp.json en la raíz del proyecto, o ~/.cursor/mcp.json para habilitarlo globalmente. El mismo bloque.Windsurf
Agrega el mismo bloque a ~/.codeium/windsurf/mcp_config.json.
Reinicia tu cliente después de editar. Las definiciones de servidores MCP se leen al arrancar, así que un cliente sin reiniciar no verá el servidor nuevo.
Paso 3 — Verifica la Conexión
Pídele a tu asistente:
> Usa la herramienta auth_confirm de DevSpeak para verificar mis credenciales.
auth_confirm no recibe argumentos. Llama a GET /api/v1/auth/confirm y devuelve tu ID de usuario como texto plano:
`text
Auth confirmed for user: kR7mQp2xY9...
`
Recibir un ID de usuario confirma tres cosas a la vez: el servidor arrancó, tu clave es válida y la ruta de red hacia la API de DevSpeak está abierta.
Paso 4 — Consulta tus Entitlements
Antes de invocar una herramienta restringida, pregunta qué puede hacer realmente tu cuenta:
> Usa get_account_info para mostrar mi tier y mis cuotas.
get_account_info devuelve la instantánea de la cuenta de GET /api/v1/me. Una cuenta DEVELOPER se ve así (recortada — la respuesta completa también incluye email, displayName y preferences):
`json
{
"tier": "DEVELOPER",
"features": [
"documentTranslation",
"iterativeRefinement",
"customInstructions",
"memoryContext",
"fileAttachments",
"apiAccess",
"customProvider",
"contextProjects"
],
"limits": {
"maxRefinements": 100,
"managedTokensPerMonth": 10000000,
"maxApiKeys": 3,
"maxContextProjects": 25
},
"usage": {
"refinementCount": 4,
"managedTokenCount": 182340,
"currentPeriod": "2026-10"
},
"quotas": {
"managedTokens": 10000000,
"apiKeys": 3,
"managedTokensUnlimited": false,
"apiKeysUnlimited": false
}
}
`
features es la lista de claves de funcionalidad que incluye tu tier — una funcionalidad ausente de la lista no está disponible. limits y quotas contienen las asignaciones, y usage lo que has consumido en el periodo.
Vale la pena hacerlo desde el principio. patch_translation_note requiere el Notes Workspace (notesWorkspace en features), exclusivo de ENTERPRISE — verificar antes convierte un fallo confuso a mitad de tarea en una respuesta clara desde el inicio.Punto de Control
En este punto deberías tener:
en la configuración MCP de tu cliente devolviendo un ID de usuario reportando tu tier y la lista de funcionalidadesSolución de Problemas
El asistente dice que no hay herramientas de DevSpeak disponibles
El servidor nunca arrancó. Confirma que tu archivo de configuración sea JSON válido — una coma final invalida silenciosamente todo el archivo y la mayoría de los clientes fallan sin error visible. Luego reinicia el cliente por completo en lugar de recargar la ventana.
Cannot reach the DevSpeak API at https://www.devspeak.dev/api/v1/auth/confirm
El servidor arrancó pero no alcanzó la red. Revisa un proxy corporativo o VPN, y luego confirma que el endpoint responde:
` curl -s -o /dev/null -w '%{http_code}\n' https://www.devspeak.dev/api/v1/auth/confirmbash
`
Un 401 es la respuesta sana aquí — demuestra que el endpoint es accesible y está rechazando una petición sin autenticar.
HTTP 401: Unauthorized
La clave es incorrecta, fue revocada o nunca se sustituyó. Confirma que reemplazaste dsk_live_TU_CLAVE_AQUI por el valor real, y verifica que la clave siga activa en Ajustes de la Cuenta → Credenciales → Claves API.
HTTP 403: Forbidden
La clave es válida pero la solicitud queda fuera de tu plan. En GRATIS o VIBECODER, error indica el motivo: se agotaron las 50 solicitudes mensuales a la API (con la fecha de reinicio) o se fijó un managedModel (la cuota gratuita usa el modelo predeterminado). Actualiza a DEVELOPER o superior para uso ilimitado.Resumen
Aprendiste a: