Recursos

Desarrolladores

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

Los sistemas externos aportan. Los humanos deciden. La verdad se mantiene gobernada.

Un agente conectado a través de la API o de MCP puede consultar el contexto aprobado al que su credencial tiene alcance —ADN de Negocio, aprendizajes activos, objetivos, trazabilidad— 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 dentro de SwiftXEO, por parte de un humano autorizado según las propias reglas de revisión y aprobación del destino —para la activación de aprendizajes en concreto, un administrador o propietario del espacio de trabajo.

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 del contexto aprobado

ADN de Negocio, aprendizajes activos, objetivos y trazabilidad (historial de decisiones y ejecución): 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

Una sola clave. Con alcance definido, revocable y adaptada al plan.

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

context:read

Instantánea del ADN de Negocio, aprendizajes activos, objetivos y trazabilidad

Plan Growth
intel:read

Búsqueda y exploración en el espacio de trabajo de temas, palabras clave, campañas, briefs y competidores

Plan Growth
learnings:propose

Proponer aprendizajes: siempre queda como PENDIENTE en la cola de revisión humana

Plan Execution
evidence:write

Enviar evidencias, señales o documentos como contexto conectado

Plan Execution
content:generate

Generación de contenido gobernado: descuenta créditos del espacio de trabajo

Plan Execution

Growth = consumir directrices aprobadas · Execution = contribuir al flujo de trabajo gobernado

API REST v1

Una sola estructura de API. Comportamiento predecible.

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.

GET/api/v1/context/dna

Instantánea del ADN de Negocio aprobado, devuelta mediante una proyección acotada de lista de permitidos

context:read
GET/api/v1/context/learnings

Aprendizajes aprobados por humanos (activos), filtrables por tipo

context:read
GET/api/v1/context/objectives

Objetivos de crecimiento abiertos

context:read
GET/api/v1/context/lineage/{entityId}

Evidencias, historial de revisiones y autorización humana para una entidad

context:read
POST/api/v1/learnings/propose

Proponer un aprendizaje: PENDIENTE hasta que un humano lo apruebe

learnings:propose
POST/api/v1/evidence

Enviar contexto conectado para revisión

evidence:write
POST/api/v1/content/generate

Generación de contenido gobernado, regulado por créditos. Envía persist: true para guardar el resultado como borrador con procedencia de proveedor/tarea adjunta; de lo contrario, el texto solo se devuelve

content:generate

Para trabajo externo de mayor duración, SwiftXEO puede emitir una asignación gobernada acotada vinculada a un objetivo, aceptar el trabajo resultante y conectar más adelante las observaciones de resultado al mismo registro operativo.

POST/api/v1/context/governed

Compila una asignación de contexto acotada para un objetivo autorizado: la forma delimitada a partir de la cual trabaja un agente externo

context:read
POST/api/v1/context/governed/results

Envía el resultado de un trabajo frente a una asignación gobernada —borrador, evidencia o propuesta de aprendizaje— que queda pendiente de revisión humana. La relación entre asignación y resultado se valida en el servidor; los identificadores inventados o vencidos se rechazan

evidence:write
POST/api/v1/outcomes/{outcomeId}/observations

Reporta una observación cualitativa o métrica sobre el resultado de un objetivo, con clave de idempotencia y sujeta a revisión humana

evidence:write
curl https://www.swiftxeo.com/api/v1/context/dna \
  -H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."

curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
  -H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..." \
  -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

Conecta un agente, no un script.

El endpoint /api/mcp utiliza HTTP sin estado ejecutable en transmisión (streamable). Los clientes alojados actualmente verificados incluyen Claude (web, escritorio, móvil) y ChatGPT, que se conectan mediante OAuth: pegue la URL, inicie sesión, seleccione un espacio de trabajo y apruebe 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 el contexto aprobado, 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_k_xxxxxxxxxxxx_..."

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

get_connection_identitycontext:read
get_business_dnacontext:read
get_active_learningscontext:read
list_objectivescontext:read
get_lineagecontext:read
get_governed_contextcontext:read
submit_governed_resultevidence:write
search_workspace_intelintel:read
propose_learninglearnings:propose
submit_evidenceevidence:write
generate_contentcontent:generate
list_content_draftscontext:read
get_content_draftcontext:read
update_content_draftcontent:generate

Las actualizaciones de borrador siguen siendo únicamente mutaciones de borrador. La revisión externa no puede aprobar, autorizar, bloquear ni publicar el artefacto, y un borrador revisado debe pasar por una nueva revisión antes de poder avanzar.

Límite

Una conexión no es un colaborador.

Una clave de API o una conexión MCP/OAuth otorga acceso entrante y con alcance definido a la API y las herramientas de SwiftXEO, nada más. No registra a quien la usa como colaborador de Agent Room, y nunca concede visibilidad de @mención dentro del Agent Room de un espacio de trabajo.

Los colaboradores de Agent Room son un conjunto fijo y separado —Claude, OpenAI, Gemini, el Asesor de SwiftXEO y Verifier— cada uno con sus propias reglas de enrutamiento y autoridad que ninguna credencial externa puede ampliar ni eludir. Un sistema relacionado pero distinto, el protocolo Local Connector, empareja un entorno de ejecución local (por ejemplo, un Mac que ejecuta tareas de Agent Room localmente) con su propio ciclo de vida de credenciales, concesión temporal y revocación, independiente tanto de las claves de API como de las conexiones MCP.

El protocolo Local Connector está relacionado, pero funciona de forma independiente. Vincula un entorno de ejecución local (como un Mac que ejecuta tareas de Agent Room) con su propio ciclo de vida de credenciales, concesiones y revocaciones. Esto se diferencia tanto de las API keys como de las conexiones MCP.

Webhooks entrantes

Firmados. Verificados. Revisados.

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. Si la verificación falla, la solicitud se rechaza antes de analizar o almacenar nada.

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

Preguntas frecuentes

¿Un agente de IA externo puede aprobar o activar un aprendizaje en SwiftXEO?

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 el contexto aprobado, aportar evidencias y proponer aprendizajes; cada propuesta queda pendiente, y la activación de aprendizajes requiere específicamente un administrador o propietario del espacio de trabajo que haya iniciado sesión como usuario humano.

¿Cómo se autentica el servidor MCP?

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.

¿Cuál es la diferencia entre el acceso Growth y Execution?

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.

¿Qué puede consultar un agente conectado sobre mis revisores?

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

Desarrolla sobre un espacio de trabajo gobernado.

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.

Explorar la Plataforma abiertaDocumentación