El Model Context Protocol (MCP) es la capa de conexión entre clientes IA (Claude Code, Cursor, asistentes de escritorio estilo ChatGPT) y herramientas externas. OmniGems incluye un servidor MCP oficial para que creadores y operadores puedan ejecutar todo su pipeline de influencers IA — agentes, posts, generación de contenido, saldo, flujos de Camunda — desde dentro de la herramienta IA que ya usan para pensar y programar.
Esta guía es la configuración de trabajo y la referencia. Cubre lo que expone OmniGems MCP, el flujo OAuth 2.1, las 16 herramientas (lectura + escritura), flujos reales que se acumulan y la postura de seguridad que todo operador debe entender antes de apuntar un cliente nuevo a datos de producción.
Por qué MCP para operaciones de influencers IA
Tres razones por las que la integración MCP cambia el flujo de trabajo diario en OmniGems AI:
- Sin cambio de contexto. Los operadores ya viven en Claude Code o Cursor para ingeniería de prompts, investigación y guiones de contenido. Añadir «monitorizar agentes», «encolar posts» y «estimar coste» como herramientas dentro del editor elimina el cambio de pestañas que destruye la concentración.
- Operaciones en lenguaje natural. «Muéstrame los tres posts de mejor rendimiento del agente @miami_condos esta semana y luego encola una actualización de mercado para el próximo lunes» es un solo turno de chat en lugar de un recorrido por 6 pantallas de UI.
- Programable desde cualquier cliente. Claude Code hoy, Cursor hoy, ChatGPT desktop mañana — las mismas herramientas están disponibles donde sea que MCP esté soportado.
Para el manual general sobre operaciones de influencers IA, ver How to Create an AI Influencer. Para agentes de publicación multiplataforma, ver How AI Agents Post on Social Media.
Qué expone OmniGems MCP
El servidor habla versión de protocolo MCP 2024-11-05 sobre JSON-RPC 2.0 y registra 16 herramientas en dos scopes:
Scope de lectura — mcp:read
| Herramienta | Qué hace |
|---|---|
| viral_list_agents | Lista tus agentes (id, username, nivel, número de posts, etiquetas) |
| viral_get_agent | Detalles completos del agente incluyendo configuración de persona |
| viral_list_posts | Lista posts con filtros; ordena por burns para los mejores |
| viral_get_post | Post completo — texto, medios, plataformas, totales de boost |
| viral_activity_daily | Quema diaria de BURNS por boost y conteo de influencers activos en 7 días |
| viral_active_processes | Flujos virales de Camunda en curso para un agente |
| viral_list_user_tasks | Tareas de usuario esperando intervención humana |
| viral_get_process_status | Snapshot de estado de un proceso Camunda específico |
| viral_get_balance | Saldo actual de la cuenta y holdings de BURNS |
| viral_estimate_cost | Estimación de coste para una solicitud de generación de contenido |
| viral_parse_influencer_description | Convierte prompts de persona en formato libre en configuración estructurada |
Scope de escritura — mcp:write
| Herramienta | Qué hace |
|---|---|
| viral_cancel_process | Cancela un flujo de generación en curso |
| viral_complete_user_task | Envía input a una tarea de usuario pausada en el flujo |
| viral_upload_media_from_url | Sube imágenes / vídeo de referencia vía URL |
| viral_create_influencer | Lanza una nueva persona IA con configuración completa |
| viral_start_content | Inicia la generación de contenido para un agente |
Cada herramienta devuelve tanto content[0].text legible por humanos como structuredContent legible por máquinas, así cualquier cliente — estilo chat o agente de código — puede parsear la respuesta limpiamente.
Inicio rápido: Claude Code
El camino más rápido. Desde tu terminal:
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
La primera llamada abre un navegador y te guía por el flujo OAuth:
- Login — inicio de sesión con wallet Web3 si no estás ya autenticado
- Consentimiento — confirma el scope (
mcp:read,mcp:read mcp:writesi se solicitan escrituras) - Intercambio de token — Claude Code almacena tokens de acceso + refresh localmente y los rota automáticamente
Después de eso, cada sesión de Claude Code tiene acceso a las herramientas OmniGems sin necesidad de re-autenticarse hasta que expire el TTL de 30 días del refresh token. Para Cursor u otro cliente MCP la URL es la misma; el registro es dinámico según RFC 7591, así que cada cliente obtiene su propio client_id.
El flujo de auth OAuth 2.1 + PKCE
El modelo de autenticación es intencionalmente estricto porque los tokens desbloquean dinero real — generaciones de pago, operaciones de saldo, agentes de publicación. El flujo completo:
| Paso | Endpoint | Spec |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Metadatos del recurso | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Registro dinámico de cliente | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
Detalles que importan para una revisión de seguridad:
- Los access tokens son JWT (24 h) con un claim
jti; la revocación escribe una entrada de denylist válida hasta la expiración natural del JWT. - Los refresh tokens son opacos (respaldados por Redis, TTL 30 d) y se rotan al usar. Reutilizar un refresh token antiguo devuelve
invalid_grant. - PKCE S256 es obligatorio. Los códigos de autorización son de un solo uso, TTL 60 segundos.
- Solo clientes públicos —
token_endpoint_auth_method: "none". No hay secretos compartidos que filtrar. - Loopback + HTTPS + esquemas URI de uso privado son los únicos patrones de
redirect_uriaceptados. - El registro dinámico de clientes está limitado a 20/h por IP.
- Los usuarios con
is_block: trueson rechazados tanto en/authorizecomo en/api/mcp. - Límites de tasa MCP: 120 solicitudes/min por usuario en general, 20/min específicamente para herramientas
mcp:write.
Cinco flujos que se acumulan
Estos son los patrones de flujo que justifican conectar el MCP a tu cliente diario. Todos funcionan en Claude Code; la mayoría funciona en cualquier cliente compatible con MCP.
1. Standup diario
«Muéstrame los 3 mejores posts de ayer en todos mis agentes, los flujos en curso y cualquier tarea de usuario que me espere».
Tres llamadas de herramientas — viral_activity_daily, viral_active_processes, viral_list_user_tasks — compuestas por el cliente IA en un único informe matutino.
2. Lanzamiento de persona
«Crea una nueva persona IA para el nicho de inmobiliaria de Coral Gables, agente licenciada de unos 35 años, voz estilo podcast, inglés + español».
El cliente convierte el formato libre en configuración estructurada vía viral_parse_influencer_description, estima el coste vía viral_estimate_cost y luego confirma vía viral_create_influencer. Tres llamadas de herramientas, un turno de chat.
3. Lote de contenido
«Estima el coste de 10 clips short-form para @luna_design y luego encólalos con hooks basados en el post de mejor rendimiento de esta semana».
viral_get_post (mejor rendimiento) → viral_estimate_cost → viral_start_content. El cliente IA aporta los hooks; el MCP aporta la orquestación.
4. Barreras de coste
«Si mi saldo cae por debajo de 1000 BURNS, cancela cualquier generación long-form en curso y notifícame».
viral_get_balance + viral_active_processes + viral_cancel_process. Conéctalo como un hook de Claude Code para chequeos periódicos.
5. Traspaso a un revisor humano
«Lista todas las tareas de usuario pausadas para @miami_condos. Para la más antigua, muéstrame los campos del formulario, redacta una respuesta en mi voz y envíala con mi aprobación».
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. El cliente IA redacta; el humano aprueba; el MCP confirma.
Para la economía general de BURNS, ver BURNS Token Glossary. Para la mecánica de tokenomics, ver Tokenomics Guide.
Arquitectura: cómo se delimitan las solicitudes
Cada llamada MCP está delimitada al usuario autenticado. Los handlers de herramientas no reenvían el JWT de wallet del usuario a servicios internos — llaman a Flow API directamente con una clave de sistema del lado del servidor más el user_id extraído del bearer token verificado. Todas las consultas de cada herramienta están delimitadas a ese user_id / webapp_user_id del lado del servidor. No existe un camino donde la sesión MCP de un usuario pueda leer agentes, posts o saldo de otro.
La misma delimitación aplica a las escrituras — viral_create_influencer y viral_start_content siempre crean recursos propiedad del llamante; viral_cancel_process solo tiene éxito para procesos que el llamante inició.
Construir tu propio flujo impulsado por MCP
El MCP es más útil cuando dejas de usarlo como reemplazo de chat para el dashboard y empiezas a usarlo como un sustrato programable. Algunos patrones que hemos visto usar a creadores:
- Monitores estilo cron — una sesión de Claude Code que se despierta cada hora, ejecuta
viral_activity_daily+viral_get_balance, y te avisa solo cuando se incumple un umbral - Portafolios de personas — un cliente IA gestiona 5–10 personas en sub-nichos adyacentes vía comandos en lenguaje natural en lugar de hacer clic 50 veces al día en un dashboard
- Coordinación entre clientes — Cursor para guiones de contenido + Claude Code para operaciones. Ambos se autentican en el mismo servidor MCP con sus propios clientes; los agentes y posts subyacentes son compartidos
- Auditorías de cumplimiento — un script de un solo uso que extrae cada post publicado vía
viral_list_postsy comprueba la divulgación contra una rúbrica interna antes de una revisión regulatoria
Para la capa de selección de nicho que debe estar por encima de cualquiera de estos flujos, ver Best AI Influencer Niches.
Roadmap
La versión actual del protocolo MCP 2024-11-05 es la base estable. El servidor OmniGems está construido para seguir la spec — los saltos de protocolo aterrizan primero en canary y luego se gradúan a producción en 2 semanas tras su release. La superficie de herramientas crece mensualmente; las adiciones recientes (las herramientas de scope de escritura llegaron a finales de 2025) cubren creación de personas y arranque de contenido, con planes para herramientas solo de analítica y compartición a nivel de equipo en próximas releases.
Si tienes una herramienta específica que quieres exponer, el flujo canónico de solicitud es abrir un issue contra la spec open-source de la herramienta — el equipo prioriza por demanda y por contratos input/output claros.
Cómo empezar
- Instala Claude Code, Cursor o cualquier cliente compatible con MCP
- Ejecuta
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp(o el equivalente en tu cliente) - Pasa por el flujo OAuth — inicia sesión con tu wallet Web3, aprueba los scopes solicitados
- Prueba
tools/listpara ver las 16 herramientas que tu token puede invocar - Empieza con
viral_activity_dailypara confirmar la conexión - Añade flujos de los patrones de arriba
El MCP es el camino más directo entre el cliente IA en el que ya piensas y el pipeline de influencers IA que mueve tu negocio. Cuanto más empujes tus operaciones diarias hacia la misma herramienta con la que razonas, más rápido se acumula todo.
Qué leer a continuación
- How to Create an AI Influencer — recorrido completo de lanzamiento
- How AI Agents Post on Social Media — agentes de publicación multiplataforma
- Best AI Influencer Niches — framework de selección de nicho
- BURNS Token Glossary — la economía del token que respalda
viral_get_balanceyviral_estimate_cost - Tokenomics Guide — bonding curves y mecánica de holders