Configuración compartida para Spoki MCP: la URL del servidor, cómo iniciar sesión, cómo crear una clave API y la configuración para otros clientes (mcp-remote, código personalizado).
¿Buscas a Claude, ChatGPT, Cursor, VS Code, o n8n? Empieza desde Consigue Empezar con Spoki MCP.
URL del servidor #
Utiliza esta dirección en todos los clientes. Cópiala tal cual: sin espacios de más ni caracteres al final:
https://mcp.spoki.com/v2/mcp
No utilices servidores de prueba hosts ni rutas antiguas /mcp rutas.
Dos formas de conectarse #
| Modo | Cuándo utilizarlo | ¿Cómo? |
|---|---|---|
| Spoki iniciar sesión | Claude, ChatGPT y los clientes con un botón de inicio de sesión | Inicia sesión en Spoki, selecciona la cuenta y haz clic en «Permitir». No pegues ninguna clave API. |
| API clave | Cursor, n8n, VS Código alternativo, personalizado código, puentes locales | Envía el encabezado X-Spoki-Api-Key junto con tu clave. |
Consigue tu API clave #
- En Spoki, ve a app.spoki.it → Integraciones → Spoki MCP → Solicitar clave API.
- Copia la clave.
- Mantén tu cuenta en privado. Cualquiera que tenga la clave podrá utilizar tu cuenta de Spoki.
Ya has terminado cuando… #
- Tienes una clave API de Spoki copiada en algún lugar seguro (o tú solo utilizas el inicio de sesión de Spoki y no necesitas una clave).
- Tú sabes qué modo utiliza tu cliente (inicio de sesión o clave de API).
Configuración genérica del cliente MCP #
| Escenario | Valor |
|---|---|
| Transporte | HTTP con transmisión continua |
| URL | https://mcp.spoki.com/v2/mcp |
| Nombre del encabezado | X-Spoki-Api-Key |
| Valor del encabezado | Tu clave de API |
n8n #
Para consultar la lista de comprobación completa de n8n (Agente de IA → Herramienta de cliente MCP → Autenticación de encabezado), véase Spoki MCP con n8n.
Clientes que necesitan mcp-remote #
Algunos clientes solo inician servidores MCP locales. Utiliza mcp-remote como puente (se requiere Node.js). Incluye siempre --transport y http-only; de lo contrario, el puente ignorará tu clave API y abrirá una página de inicio de sesión.
{
"mcpServers": {
"spoki": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.spoki.com/v2/mcp",
"--transport",
"http-only",
"--header",
"X-Spoki-Api-Key: YOUR_API_KEY"
]
}
}
}
Para los servidores locales de Claude Desktop, pega esto en claude_desktop_config.json (Configuración → Desarrollador → Editar configuración), sustituye YOUR_API_KEY, guarda los cambios y reinicia Claude Desktop. La configuración local solo funciona mientras el ordenador esté encendido. Para Claude en la web, en el móvil o en tareas programadas, utiliza en su lugar la guía de Claude.
Comprueba tu clave de API #
Sustituye YOUR_API_KEY por tu clave:
curl -X POST https://mcp.spoki.com/v2/mcp \
-H "X-Spoki-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
Una clave válida devuelve una respuesta con "serverInfo". Una clave no válida devuelve invalid_api_key.
Problemas habituales #
- invalid_api_key: Crea una nueva clave en Spoki Integrations → Spoki MCP y pégala sin espacios.
- Página de inicio de sesión en lugar de «Herramientas»: Para mcp-remote, añade
--transport http-only. Para Claude/ChatGPT, utiliza el inicio de sesión de Spoki, no una clave API. - URL incorrecta o caducada URL: Utiliza solo
https://mcp.spoki.com/v2/mcp.
¿Necesitas ayuda? support@spoki.com.
