Recursos
SwiftXEO expone una API REST con alcance a nivel de espacio de trabajo, un servidor MCP con OAuth y webhooks entrantes firmados: cada superficie de escritura es solo para propuestas, y la aprobación queda en manos de usuarios humanos autenticados.
Conecta Claude, ChatGPT, Cursor o un sistema personalizado a tu ADN de Negocio aprobado, tus objetivos y tus aprendizajes activos; además, aporta evidencias y propuestas a través del mismo flujo de revisión humana que gobierna todo lo demás.
Doctrina central
Un agente conectado a través de la API o de MCP puede consultar todo lo que tu espacio de trabajo ha aprobado y realizar un trabajo útil basado en ello. Puede observar elementos dignos de revisión y proponer una lección que valga la pena aprender. Lo que no puede hacer es decidir que su propia conclusión es correcta.
Ningún alcance, herramienta o carga útil de webhook puede aprobar o activar un aprendizaje. Esa decisión ocurre una sola vez, dentro del producto, por parte de un administrador del espacio de trabajo: el mismo filtro por el que ya pasa cada propuesta generada internamente.
Principios de la Plataforma abierta
Acceso vinculado a credenciales
El espacio de trabajo se deriva de la clave. No se puede seleccionar ni sobrescribir mediante un parámetro de la solicitud.
Lectura de la verdad aprobada
ADN de Negocio, aprendizajes activos, objetivos y trazabilidad: el mismo registro que el producto muestra a un usuario humano.
Proponer, nunca aprobar
Las escrituras externas quedan almacenadas como pendientes. Ningún alcance llega a la ruta de autorización.
Recepción de evidencias firmadas
Las cargas útiles de los webhooks se verifican mediante HMAC y se almacenan como contexto conectado para su revisión; nunca se ejecutan.
No verificado por defecto
El material externo se marca como no verificado al ingresarlo. La promoción es siempre una decisión humana.
Proyectado, no sin procesar
Las respuestas son proyecciones basadas en listas de permitidos. Los identificadores internos permanecen dentro; los revisores aparecen bajo etiquetas de rol, no con sus nombres.
Autenticación
Crea una clave de API de espacio de trabajo en Configuración → Infraestructura → Acceso a la Plataforma abierta (se requiere ser administrador del espacio de trabajo). El secreto se muestra una sola vez; solo se almacena su hash. Los alcances de lectura se incluyen desde el plan Growth; los alcances de escritura requieren el plan Execution y se vuelven a comprobar al momento de su uso, por lo que un cambio de plan se aplica en la siguiente solicitud.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Instantánea del ADN de Negocio, aprendizajes activos, objetivos y trazabilidad
Búsqueda y exploración en el espacio de trabajo de temas, palabras clave, campañas, briefs y competidores
Proponer aprendizajes: siempre queda como PENDIENTE en la cola de revisión humana
Enviar evidencias, señales o documentos como contexto conectado
Generación de contenido gobernado: descuenta créditos del espacio de trabajo
Growth = consumir directrices aprobadas · Execution = contribuir al flujo de trabajo gobernado
API REST v1
Cada respuesta utiliza la misma estructura: { data, meta? } en caso de éxito, { error: { code, message } } en caso contrario. Las lecturas están limitadas a 60 solicitudes por minuto por espacio de trabajo, y las escrituras a 20. La generación descuenta créditos del espacio de trabajo antes de realizar la llamada al modelo.
Instantánea del ADN de Negocio aprobado: una proyección basada en lista de permitidos de la verdad organizacional
Aprendizajes aprobados por humanos (activos), filtrables por tipo
Objetivos de crecimiento abiertos
Evidencias, historial de revisiones y autorización humana para una entidad
Proponer un aprendizaje: PENDIENTE hasta que un humano lo apruebe
Enviar contexto conectado para revisión
Generación de contenido gobernado, regulado por créditos
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "content_learnings",
"category": "overclaim",
"lesson": "Avoid absolute performance claims without evidence.",
"evidenceNote": "Three campaign replies flagged the launch copy as overstated."
}'Servidor MCP
El endpoint /api/mcp funciona con HTTP sin estado de tipo transmisión (streamable). Los clientes alojados (Claude web, escritorio y móvil, y ChatGPT en modo desarrollador) se conectan mediante OAuth: pega la URL, inicia sesión, elige un espacio de trabajo y aprueba el acceso. Los clientes basados en archivos de configuración, como Claude Code y Cursor, utilizan una clave estática del espacio de trabajo.
La lista de herramientas se filtra según los alcances de la conexión: las herramientas de lectura devuelven la verdad aprobada, mientras que las de escritura solo proponen. Deliberadamente, no existe ninguna herramienta de aprobación, activación o autorización en ningún alcance.
Claude Code, Cursor y otros clientes basados en archivos de configuración
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
Claude web, escritorio, móvil y ChatGPT
Añadir conector personalizado URL: https://www.swiftxeo.com/api/mcp → Inicia sesión en SwiftXEO, elige un espacio de trabajo, aprueba el acceso. No hay que pegar ninguna clave: esta conexión utiliza OAuth.
Herramientas disponibles
Webhooks entrantes
Crea una fuente entrante en Configuración → Infraestructura → Fuentes entrantes para recibir un endpoint y un secreto de firma únicos por fuente. Cada carga útil se verifica mediante HMAC-SHA256 sobre el cuerpo sin procesar antes de registrarse como contexto conectado: material para revisión humana, nunca la verdad por sí sola.
El plan Growth incluye una fuente activa; el plan Execution permite múltiples fuentes.
POST /api/hooks/{workspaceId}/{sourceId}
X-Signature: sha256=<hmac of raw body>
{
"kind": "signal",
"title": "CRM: deal closed",
"body": "Acme signed the annual
plan after the Q3 campaign."
}Preguntas
No. Ningún alcance de API, herramienta MCP o webhook puede cambiar una propuesta a aprobada ni acceder a la ruta de autorización. Los sistemas externos pueden consultar la verdad aprobada, aportar evidencias y proponer aprendizajes; cada propuesta queda pendiente, y solo un administrador del espacio de trabajo que haya iniciado sesión como usuario humano puede aprobarla.
Mediante dos tipos de credenciales en la misma cabecera bearer: una clave de API estática del espacio de trabajo para clientes basados en archivos de configuración, o un token de acceso OAuth para clientes alojados como Claude y ChatGPT. En ambos casos, el espacio de trabajo proviene de la credencial, nunca de los argumentos de la herramienta.
Growth abarca las lecturas: ADN de Negocio, objetivos, aprendizajes activos, trazabilidad y búsqueda en el espacio de trabajo, además de una fuente de webhook entrante. Execution añade escrituras: propuesta de aprendizajes, envío de evidencias, generación de contenido gobernado y múltiples fuentes entrantes.
Únicamente las etiquetas de rol. Las respuestas externas se proyectan a través de una capa de ocultación: las identidades de revisores y autores pasan a ser "Administrador del espacio de trabajo", y los identificadores internos se eliminan antes de que cualquier dato salga del espacio de trabajo.
La referencia completa de la plataforma se encuentra en la documentación, y la página de Plataforma abierta explica el modelo de gobernanza que aplican estos endpoints.