SumUp

O servidor Model Context Protocol (MCP) da SumUp para interações entre modelos de linguagem de grande porte (LLMs) e as APIs da SumUp. O servidor MCP permite conectar-se aos serviços da SumUp a partir de um cliente MCP (por exemplo, Cursor, Claude) e usar linguagem natural para trabalhar com sua conta SumUp.

Este pacote é executado como um Cloudflare Worker e fornece o transporte MCP para a SumUp.

A autenticação segue o fluxo de servidor de recursos OAuth do MCP:

• O worker publica metadados de recursos protegidos que apontam os clientes para o servidor de autorização da SumUp.
• Os clientes enviam Authorization: Bearer <access-token> para /mcp.
• Os tokens Bearer devem ser tokens de acesso JWT emitidos por SUMUP_AUTH_HOST e válidos para a URL do recurso do worker.

Chaves de API da SumUp, como sup_sk_..., não são tokens Bearer válidos para o servidor hospedado.

O worker expõe /mcp para HTTP Streamable e /sse para o transporte SSE legado. Ambas as rotas são vinculadas a um Durable Object para que o estado da sessão MCP sobreviva entre requisições na mesma implantação do Worker.

Uso a partir de um cliente MCP

Qualquer cliente que suporte o transporte HTTP Streamable pode se conectar a este servidor. Por exemplo, usando mcp-remote:

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

Substitua <your-access-token> por um token de acesso OAuth emitido para o recurso MCP. Clientes com suporte a OAuth podem descobrir o servidor de autorização a partir dos metadados do recurso protegido, em vez de exigir que um token seja configurado manualmente.

Desenvolvimento

Configuração de desenvolvimento, testes locais e fluxo de trabalho para contribuidores estão em CONTRIBUTING.md.