Servidor MCP de Platica
El servidor MCP (Model Context Protocol) de Platica permite trabajar con sus datos mediante herramientas invocables desde clientes compatibles. Ofrece un catálogo completo para integraciones personalizadas y un perfil reducido para los plugins platic.
Los plugins usan OAuth con tu cuenta de Platica y los workspaces que autorices. Las integraciones personalizadas también pueden usar una API Key, como en REST. Cada operación respeta los permisos de la credencial.
Perfiles y URL del servidor
| Perfil | URL | Uso |
|---|---|---|
| Completo | https://api.platica.mx/mcp | Integraciones MCP personalizadas con el catálogo completo. |
| Plugins | https://api.platica.mx/mcp/apps | Perfil reducido utilizado por los plugins y conectores platic en plataformas compatibles. |
/mcp/apps es un perfil del mismo servidor, no otra versión del producto. Otros clientes compatibles también pueden conectarse a esa URL.
El perfil de plugins permite trabajar con conversaciones, clientes, plantillas aprobadas de WhatsApp, campañas, configuración de agentes, comentarios y uso del workspace. Excluye la ejecución genérica de agentes, herramientas personalizadas, administración de webhooks y otras operaciones del catálogo completo. Consulta el catálogo de plugins .
Sus respuestas muestran los campos seleccionados para cada herramienta y omiten el cuerpo completo de la API (structuredContent). Pueden incluir nombres, teléfonos o mensajes cuando la operación los necesita. Reducir la respuesta no implica que deje de contener datos personales.
El perfil no concede permisos adicionales. Conectar una cuenta no autoriza por sí mismo envíos, cambios o eliminaciones: los plugins requieren una solicitud explícita y confirmación para acciones que llegan a terceros o no pueden deshacerse. Platica no admite transferencias de dinero ni consultas de saldos bancarios.
- Método:
POST(JSON-RPC 2.0 sobre Streamable HTTP) - Autenticación: OAuth 2.1 (recomendado) o
Authorization: Bearer pl_key_... - Modo: stateless + JSON (no requiere sesiones persistentes ni SSE)
- Spec: Streamable HTTP
2025-11-25
¿Qué incluye?
Herramientas listas — El catálogo completo cubre la API REST;
/mcp/appsexpone solo la selección destinada a los plugins.tools/listmuestra el catálogo del perfil conectado.La misma API, dos puertas — OAuth te conecta con tu usuario y tu rol. La API Key cubre el workspace completo, igual que en REST. Lo que un endpoint puede hacer, su herramienta MCP lo hace igual.
Sin servidor adicional — Conecta tu cliente al perfil que necesitas. No tienes que alojar un servidor MCP propio.
Schemas auto-generados — Cada herramienta publica su
inputSchema(JSON Schema) para que el LLM sepa qué argumentos enviar.
Siguientes pasos
| Sección | Descripción |
|---|---|
| Configuración | Snippets de conexión para Cursor, Claude, VS Code y otros clientes |
| Autenticación | OAuth 2.1 (inicio de sesión + workspaces) y API Key |
| Tools — Introducción | Catálogo de plugins, recursos completos, anotaciones y efectos |
| Workspaces | list_workspaces: el primer tool después de conectar con OAuth |
| Documentación | search_product_docs: cómo funciona Platica |
| Errores | Cómo se mapean los errores REST a respuestas MCP |
Para usar el alcance de los plugins, conecta https://api.platica.mx/mcp/apps y autoriza con OAuth. Para una integración personalizada con el catálogo completo, usa /mcp. No hace falta generar una API Key si el cliente admite OAuth.