Configuración del cliente MCP
El servidor MCP de Platica habla Streamable HTTP (spec 2025-11-25) — el transporte HTTP oficial del Model Context Protocol. Cualquier cliente compatible con este transporte puede conectarse directo a:
https://api.platica.mx/mcp Sólo necesitas una API Key activa .
Cursor
Edita ~/.cursor/mcp.json (o .cursor/mcp.json dentro de tu proyecto) y agrega:
{
"mcpServers": {
"platica": {
"url": "https://api.platica.mx/mcp",
"headers": {
"Authorization": "Bearer pl_key_TU_KEY_ID_TU_SECRETO"
}
}
}
} Reinicia Cursor. En la barra inferior verás el servidor platica con un círculo verde y la lista de herramientas disponibles.
Claude Code
Desde tu terminal:
claude mcp add --transport http platica https://api.platica.mx/mcp \
--header "Authorization: Bearer pl_key_TU_KEY_ID_TU_SECRETO" O bien añádelo manualmente en .mcp.json:
{
"mcpServers": {
"platica": {
"transport": "http",
"url": "https://api.platica.mx/mcp",
"headers": {
"Authorization": "Bearer pl_key_TU_KEY_ID_TU_SECRETO"
}
}
}
} Claude Desktop
Claude Desktop usa stdio en su config local, así que el servidor remoto se conecta a través del puente mcp-remote. Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"platica": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.platica.mx/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer pl_key_TU_KEY_ID_TU_SECRETO"
}
}
}
} Invalid note type. Should be either "note", "tip", "important", "warning", "caution"
Si tienes Claude Pro o superior, también puedes añadirlo desde Settings → Connectors → Custom Connectors apuntando directamente a https://api.platica.mx/mcp con tu Bearer token.
VS Code (GitHub Copilot)
En tu settings.json:
{
"github.copilot.chat.mcp.servers": {
"platica": {
"type": "http",
"url": "https://api.platica.mx/mcp",
"headers": {
"Authorization": "Bearer pl_key_TU_KEY_ID_TU_SECRETO"
}
}
}
} Cualquier otro cliente
Si tu cliente soporta el transporte oficial Streamable HTTP (post-2025-03-26), apúntalo a:
| Parámetro | Valor |
|---|---|
| URL | https://api.platica.mx/mcp |
| Método HTTP | POST |
| Headers obligatorios | Accept: application/json, text/event-streamContent-Type: application/jsonAuthorization: Bearer pl_key_... |
| Sesión | Stateless (no se requiere Mcp-Session-Id) |
| SSE | No usado (las respuestas siempre son application/json) |
Verifica la conexión
Una vez configurado, pide al agente que ejecute tools/list o pregunta algo como "¿qué herramientas tienes disponibles del MCP de Platica?". Deberías ver las 40 herramientas listadas, agrupadas por recurso.
Si el cliente reporta error 401, revisa que tu API Key empiece con pl_key_ y que esté activa en el dashboard de Platica.