What is MCP?
MCP, o Model Context Protocol, es una forma estándar de que los clientes de IA se conecten a productos externos. En lugar de pedirle a un asistente que adivine cómo funciona Ocoya, conectas el asistente a Ocoya MCP y puede descubrir herramientas tipadas para las acciones compatibles.
Ocoya MCP expone herramientas de brand, publishing, brand, Studio y workflow después de que el usuario aprueba el acceso OAuth.
AI client connects
Claude, ChatGPT, Codex, VS Code u otro cliente compatible con MCP se conecta a https://mcp.ocoya.com mediante Streamable HTTP MCP.
User approves access
Ocoya abre un flujo de aprobación OAuth donde el usuario inicia sesión, revisa los permisos y selecciona las brands a las que el cliente puede acceder.
Ocoya tools become available
El cliente aprobado puede crear y gestionar posts, programar contenido, aplicar brand context y ejecutar workflows dentro de las brands seleccionadas.
Why use MCP for Ocoya?
MCP es útil cuando quieres que un asistente de IA realice acciones del producto de forma directa y segura:
- El asistente puede descubrir herramientas de Ocoya en lugar de inventar llamadas a la API.
- Los usuarios aprueban el acceso mediante OAuth en lugar de copiar API keys.
- El acceso a brands se limita a las brands seleccionadas durante la aprobación.
- Las llamadas a tools devuelven datos estructurados que los clientes pueden usar en acciones posteriores.
What Ocoya exposes
Ocoya MCP ofrece a los clientes aprobados herramientas para:
| Area | What the assistant can do |
|---|---|
| Account and brand | Identificar al usuario autorizado y listar las brands aprobadas. |
| Social profiles | Listar los canales conectados e iniciar nuevos flujos de conexión social. |
| Posts | Crear, inspeccionar, actualizar, programar, publicar y eliminar grupos de posts. |
| AI drafts | Generar borradores de posts editables a partir de prompts y contexto visual opcional. |
| Creative context | Listar hashtag libraries y Studio templates. |
| Workflows | Listar, inspeccionar, activar, desactivar y ejecutar workflows. |
Authentication model
Ocoya MCP usa OAuth. Un cliente no puede usar Ocoya MCP con una Ocoya API key.
Cuando el cliente necesita por primera vez una Ocoya tool, abre Ocoya en el navegador. El usuario inicia sesión, revisa los permisos solicitados, selecciona las brands permitidas y aprueba el cliente.
El cliente recibe un access token de corta duración y puede renovar el acceso según el flujo OAuth. Si una brand no se seleccionó durante la aprobación, las tools no pueden acceder a esa brand.
MCP vs REST API
Usa MCP cuando un cliente de IA deba actuar en nombre del usuario mediante lenguaje natural y llamadas a tools.
Usa la REST API cuando estés creando una integración backend, un trabajo programado o una aplicación que llame directamente a los endpoints de Ocoya.