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 .
Instalación rápida
Usa los botones para instalar el servidor en un clic. Cursor y VS Code abren el cliente con la config lista; Claude Code y Antigravity copian el comando/config al portapapeles (esos clientes no soportan enlaces de instalación). Tras instalar, reemplaza el placeholder por tu API Key .
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"
}
}
}
} mcp-remote traduce stdio ↔ Streamable HTTP de forma transparente. La API Key viaja en env.AUTH_HEADER para no quedar en texto plano en el array args.
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"
}
}
}
} Antigravity
Antigravity no soporta enlaces de instalación, así que se configura manualmente. Abre el panel del agente → menú "..." → MCP Servers → Manage MCP Servers → View raw config, y agrega a mcp_config.json (~/.gemini/antigravity/mcp_config.json):
{
"mcpServers": {
"platica": {
"serverUrl": "https://api.platica.mx/mcp",
"headers": {
"Authorization": "Bearer pl_key_TU_KEY_ID_TU_SECRETO"
}
}
}
} Antigravity usa serverUrl (no url) para servidores HTTP. Reinicia Antigravity tras guardar.
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 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.