Empezar

Servidor MCP

Utilice las herramientas y recursos Epismo de los clientes MCP, incluida la configuración, la autenticación, las sesiones y el comportamiento de las herramientas.

El servidor Epismo MCP expone operaciones de paquete, seguimiento, registro, alias y sugerencias como herramientas de protocolo de contexto de modelo. Los clientes de IA pueden leer el contexto reutilizable de los paquetes y luego crear o actualizar seguimientos de tareas y objetivos cuando el trabajo se vuelve procesable. El servidor también expone recursos de contexto para el usuario, proyectos, usuarios y agentes actuales para que los clientes puedan elegir los ID y alcances correctos antes de mutar los datos.

Cuándo utilizar MCP

Utilice MCP cuando un cliente de IA deba operar Epismo directamente.

Gol Por qué encaja MCP
Permitir que un agente encuentre paquetes de contexto reutilizables Puede llamar a epismo_pack_search y epismo_pack_get
Deje que un agente divida un plan en tareas Puede crear múltiples pistas con epismo_track_apply
Deje que ChatGPT o Claude lean el contexto del equipo OAuth y los recursos preservan el contexto del usuario/espacio de trabajo
Permitir que un agente actualice un paquete de flujo de trabajo Las herramientas de actualización de paquetes utilizan la semántica PATCH

Utilice HTTP API para integraciones de backend, CLI para flujos de trabajo locales y de CI, y MCP para acceso directo entre agente y cliente.

Identidad y transporte del servidor

  • Nombre del servidor: epismo-mcp
  • Punto final de transporte: POST / para Streamable HTTP JSON-RPC
  • Cierre de sesión: DELETE /
  • Comprobaciones de estado: GET /health, GET /healthz
  • Metadatos de recursos protegidos OAuth: GET /.well-known/oauth-protected-resource
  • Metadatos del servidor de autorización OAuth: GET /.well-known/oauth-authorization-server

Autenticación

Los clientes MCP se autentican con Authorization: Bearer <oauth_access_token>. El token debe incluir el alcance mcp. Los metadatos del servidor anuncian mcp y offline_access, lo que permite a los clientes actualizar los tokens de acceso sin forzar el inicio de sesión cada vez.

El flujo de configuración del cliente es:

  1. Registre la URL del servidor Epismo MCP en su cliente MCP.
  2. Complete OAuth y otorgue el alcance mcp.
  3. Envíe la solicitud de inicialización MCP.
  4. Guarde el ID de sesión devuelto.
  5. Lea los recursos antes de llamar a las herramientas de mutación.

Sesiones

La primera solicitud es MCP initialize. El servidor devuelve un encabezado Mcp-Session-Id y espera que el cliente envíe ese encabezado en solicitudes posteriores en la misma sesión. Utilice DELETE / para cerrar una sesión.

curl -i https://mcp.epismo.ai/ \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "authorization: Bearer $EPISMO_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0.1.0"}}}'

Recursos

Lea los recursos antes de elegir ID para llamadas de herramientas.

URI Contenidos
epismo://context/current_user Usuario/cuenta/espacio de trabajo actual JSON
epismo://context/projects Proyectos accesibles en el espacio de trabajo seleccionado
epismo://context/users Usuarios del espacio de trabajo visibles para la persona que llama
epismo://context/agents Agentes instalados disponibles para asignación

Los encargados de tareas pueden utilizar ID de usuario o ID de agente. Los asignados a los pasos del paquete de flujo de trabajo utilizan human o ID de agente únicamente.

Consulte Recursos para ver ejemplos de carga útil y reglas de campo de acceso.

Empacar herramientas

Herramienta Propósito Costo
epismo_pack_create Crear flujos de trabajo o contextos 5 créditos
epismo_pack_search Buscar flujos de trabajo o contextos 5 créditos
epismo_pack_get Leer esquema, contenido anidado seleccionado o contenido completo 1 crédito
epismo_pack_update Parchear un paquete por UUID, alias, URL compartida o URL central 1 crédito
epismo_pack_like Me gusta o no me gusta un paquete 1 crédito
epismo_pack_rate Califica si un paquete funcionó cuando lo usaste 1 crédito
epismo_pack_delete Elimine un paquete y alias de su propiedad que apunten a él 1 crédito
epismo_pack_run Expandir un flujo de trabajo a un objetivo y tareas 1 crédito

Para paquetes grandes, comience con epismo_pack_get en modo esquema. Utilice contentIndex.stepIds o contentIndex.blockIds de la respuesta para recuperar solo el contenido anidado que necesita el agente. Utilice full=true solo cuando el cliente realmente necesite el paquete completo.

Consulte Tools para ver ejemplos de argumentos de herramientas.

Herramientas de seguimiento

Herramienta Propósito Costo
epismo_track_search Buscar tareas/metas con filtros 2 créditos
epismo_track_create Crear una tarea u objetivo 1 crédito
epismo_track_update Parchear una tarea u objetivo por UUID/URL 1 crédito
epismo_track_get Leer una pista 1 crédito
epismo_track_apply Crear/actualizar/eliminar pistas de forma masiva 1 crédito
epismo_track_delete Eliminar una pista 1 crédito
epismo_track_review Generar una reseña Uso de tokens de IA

Cuando un agente planifica varias tareas, epismo_track_apply suele ser la mejor herramienta. Los identificadores que no son UUID permiten que el agente exprese dependencias dentro de la misma llamada.

Cuando un agente está explorando, primero limite los filtros y obtenga detalles solo de las pistas que importan.

Utilice epismo_track_review después de finalizar una tarea o completar/posponer un objetivo para generar una revisión de solo lectura de uno o más objetivos, pistas relacionadas, registros y paquetes de origen. Las revisiones detalladas consumen créditos según el uso subyacente del token de IA.

Herramientas de registro

Herramienta Propósito Costo
epismo_log_create Agregar un registro/comentario a una pista gratis
epismo_log_list Listar registros: para una pista o para todas las pistas 1 crédito
epismo_log_delete Eliminar un registro gratis

Los registros adjuntan actividad, comentarios y notas de revisión a las pistas sin cambiar los propios campos de la pista.

Comportamiento crediticio

Los costos de las herramientas se enumeran en las tablas anteriores. Los créditos se consumen del contexto personal/del espacio de trabajo actual resuelto por el token OAuth. Si el contexto no tiene suficientes créditos, la llamada a la herramienta puede fallar con un error de crédito/pago.

Herramientas de alias

Herramienta Propósito Costo
epismo_alias_upsert Crear o redireccionar un alias para un paquete de su propiedad 5 créditos
epismo_alias_get Resolver un único alias en su paquete 1 crédito
epismo_alias_list Enumere sus alias personales y de espacio de trabajo activo 2 créditos
epismo_alias_delete Eliminar un alias 1 crédito

Los alias apuntan únicamente a paquetes. Las pistas están referenciadas por UUID o URL que contienen un UUID.

Herramientas de sugerencia

Herramienta Propósito Costo
epismo_suggestion_create Enviar una sugerencia de mejora al propietario de un paquete 5 créditos
epismo_suggestion_get Lea una sugerencia, opcionalmente con la instantánea 1 crédito
epismo_suggestion_list Lista de sugerencias enviadas, recibidas o por paquete 2 créditos
epismo_suggestion_update Actualiza tu propia sugerencia 1 crédito
epismo_suggestion_resolve Establecer el estado de una sugerencia de su propiedad 1 crédito

Las sugerencias son propuestas de mejora para paquetes basadas en texto. Cualquiera que pueda leer un paquete puede crear uno; sólo el autor puede actualizarlo y sólo el propietario del paquete puede resolverlo. Consulte Tools para conocer los parámetros.

Alcances y uso compartido

Las herramientas de mutación MCP utilizan el mismo modelo de acceso que API.

{ "scope": { "type": "personal" } }
{ "scope": { "type": "projects", "ids": ["project-id"] } }

Las herramientas de búsqueda aceptan scopes, una variedad de ámbitos personales/de proyectos. Las herramientas de mutación aceptan sharedWith con userIds y emails. Al actualizar, los campos de acceso omitidos conservan la configuración de acceso del registro existente.

En esta sección