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

PerfilURLUso
Completohttps://api.platica.mx/mcpIntegraciones MCP personalizadas con el catálogo completo.
Pluginshttps://api.platica.mx/mcp/appsPerfil 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?

  1. Herramientas listas — El catálogo completo cubre la API REST; /mcp/apps expone solo la selección destinada a los plugins. tools/list muestra el catálogo del perfil conectado.

  2. 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.

  3. Sin servidor adicional — Conecta tu cliente al perfil que necesitas. No tienes que alojar un servidor MCP propio.

  4. Schemas auto-generados — Cada herramienta publica su inputSchema (JSON Schema) para que el LLM sepa qué argumentos enviar.


Siguientes pasos

SecciónDescripció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