Empezar

Configuración

Conecte un cliente MCP a Epismo y comprenda la autenticación.

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

Transporte

  • Nombre del servidor: epismo-mcp
  • Punto final HTTP transmitible: POST /
  • Cierre de sesión: DELETE /
  • Comprobaciones de estado: GET /health, GET /healthz

##OAuth

Los clientes MCP se autentican con Authorization: Bearer <oauth_access_token>. El token debe incluir el alcance mcp. El servidor publica metadatos OAuth en:

  • GET /.well-known/oauth-protected-resource
  • GET /.well-known/oauth-authorization-server

Al emitir tokens MCP a través de API, pase resource como la URL absoluta http o https del recurso del servidor MCP. La actualización del token también requiere refreshToken y resource.

Ciclo de vida de la sesión

La primera solicitud es MCP initialize. El servidor devuelve Mcp-Session-Id y los clientes envían ese encabezado en solicitudes posteriores en la misma 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":"my-client","version":"0.1.0"}
    }
  }'

Copie el encabezado de respuesta Mcp-Session-Id devuelto en solicitudes JSON-RPC posteriores. Envía DELETE / con el mismo encabezado cuando el cliente quiera cerrar la sesión.

Primeras llamadas

Después de initialize, enumere o lea los recursos antes que las herramientas de mutación. El orden habitual es:

  1. Lea epismo://context/current_user para confirmar el contexto personal versus el del espacio de trabajo.
  2. Lea epismo://context/projects antes de utilizar el alcance de un proyecto.
  3. Lea epismo://context/users o epismo://context/agents antes de configurar los asignados.
  4. Utilice herramientas de búsqueda u obtención para inspeccionar paquetes/pistas existentes.
  5. Llame a las herramientas de creación/actualización/aplicación solo después de que los ID y los alcances estén claros.

Esto mantiene las acciones de los agentes deterministas y evita adivinar los ID de proyecto, de usuario o de agente a partir de los nombres.

Dónde conectarse

Apunte su cliente MCP al servidor alojado:

https://mcp.epismo.ai/

No es necesario instalar ni ejecutar nada usted mismo; Epismo aloja el servidor MCP. Registre esa URL en su cliente, complete OAuth con el alcance mcp y comience con la solicitud initialize anterior.