Servidor MCP de SumUp

El servidor de Model Context Protocol (MCP) de SumUp para interacciones entre modelos de lenguaje grandes (LLMs) y las APIs de SumUp. El servidor MCP te permite conectarte a los servicios de SumUp desde un cliente MCP (por ejemplo, Cursor, Claude) y usar lenguaje natural para trabajar con tu cuenta de SumUp.

Este paquete se ejecuta como un Cloudflare Worker y sirve el transporte MCP para SumUp.

La autenticación sigue el flujo de servidor de recursos OAuth de MCP:

El worker publica metadatos de recursos protegidos que dirigen a los clientes al servidor de autorización de SumUp.
Los clientes envían Authorization: Bearer <access-token> a /mcp.
Los tokens Bearer deben ser tokens de acceso JWT emitidos por SUMUP_AUTH_HOST y válidos para la URL del recurso del worker.

Las claves de API de SumUp como sup_sk_... no son tokens Bearer válidos para el servidor alojado.

El worker expone /mcp para Streamable HTTP y /sse para el transporte SSE heredado. Ambas rutas están vinculadas a un Durable Object para que el estado de la sesión MCP persista entre solicitudes dentro del mismo despliegue del Worker.

Uso desde un cliente MCP

Cualquier cliente que hable el transporte Streamable HTTP puede conectarse a este servidor. Por ejemplo, usando mcp-remote:

{
  "mcpServers": {
    "sumup": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.sumup.com/mcp",
        "--headers",
        "Authorization: Bearer <your-access-token>"
      ]
    }
  }
}

Reemplaza <your-access-token> con un token de acceso OAuth emitido para el recurso MCP. Los clientes compatibles con OAuth pueden descubrir el servidor de autorización desde los metadatos del recurso protegido en lugar de requerir que se configure un token manualmente.

Desarrollo

La configuración de desarrollo, las pruebas locales y el flujo de trabajo para contribuidores se encuentran en CONTRIBUTING.md.

SumUp

Documentación