Set up your AI assistant

Install the Codex Plugin

Run these commands in your terminal:

codex plugin marketplace add sumup/sumup-skills
codex plugin add sumup@sumup
codex plugin list

Start a new Codex session to load the skills and tools. Complete the SumUp authorization flow when prompted.

Plugins are supported in the Codex CLI and Codex in the ChatGPT desktop app. For the Codex IDE extension, install standalone skills and use the direct MCP instructions below.

See the OpenAI plugin documentation(Opens in a new tab).

Connect Codex Directly

Run these commands in your terminal:

codex mcp add sumup --url https://mcp.sumup.com/mcp
codex mcp login sumup
codex mcp list

Complete the browser login. In a Codex session, use /mcp to check the active tools.

Alternatively, add this entry to ~/.codex/config.toml, then run codex mcp login sumup:

[mcp_servers.sumup]
url = "https://mcp.sumup.com/mcp"

The Codex CLI, ChatGPT desktop app, and Codex IDE extension share this MCP configuration on the same host. See the OpenAI MCP documentation(Opens in a new tab).

Install the Claude Code Plugin

Run these commands in your terminal:

claude plugin marketplace add sumup/sumup-skills
claude plugin install sumup@sumup
claude plugin list

You can also run /plugin marketplace add sumup/sumup-skills and /plugin install sumup@sumup inside Claude Code.

Open /plugin to confirm SumUp is installed. Follow the install summary’s reload instructions, then open /mcp and authenticate the SumUp server in your browser.

See the Claude Code plugin documentation(Opens in a new tab).

Connect Claude Code Directly

Add the server from your terminal:

claude mcp add --transport http --scope user sumup https://mcp.sumup.com/mcp
claude mcp list

Open Claude Code, run /mcp, and select the SumUp server to authenticate in your browser. The user scope makes the connection available across your projects.

See the Claude Code MCP documentation(Opens in a new tab).

Install the Cursor Plugin

For a team marketplace, an administrator can import the repository:

1. Open the Cursor dashboard and go to Plugins & MCPs.
2. Under Team Marketplaces, choose Add Marketplace, then Import from Repo.
3. Enter https://github.com/sumup/sumup-skills and add the SumUp plugin to the marketplace.
4. In Cursor, install SumUp from your team’s marketplace and authorize the MCP connection when prompted.

For an individual setup, install standalone SumUp skills and add the hosted MCP server using the configuration below.

See the Cursor plugin documentation(Opens in a new tab).

Connect Cursor Directly

Add this entry to ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project. Merge it with any existing servers:

{
  "mcpServers": {
    "sumup": {
      "url": "https://mcp.sumup.com/mcp"
    }
  }
}

Open Cursor’s MCP settings, connect the SumUp server, and complete authorization in your browser. Check that its tools are available in Agent.

See the Cursor MCP documentation(Opens in a new tab).

Install the Gemini Extension

Install the SumUp extension from your terminal:

gemini extensions install https://github.com/sumup/sumup-skills --ref=main
gemini extensions list

Start a new Gemini CLI session. Run /mcp to check the SumUp server and /mcp auth sumup to complete authorization in your browser.

See the Gemini CLI extension documentation(Opens in a new tab).

Connect Gemini CLI Directly

Add the server from your terminal:

gemini mcp add --transport http --scope user sumup https://mcp.sumup.com/mcp
gemini mcp list

Start Gemini CLI and run /mcp auth sumup to sign in through your browser. Use /mcp to check the server and its tools.

See the Gemini CLI MCP documentation(Opens in a new tab).

Install the Kiro Power

Import SumUp as a custom power:

1. Open Powers.
2. Select Add Custom Power, then Import power from GitHub.
3. Enter https://github.com/sumup/sumup-skills.
4. Activate the SumUp power and complete authentication when its MCP tools are needed.

For local testing, use Import power from a folder and select a clone of the repository.

See the Kiro power installation documentation(Opens in a new tab).

Connect VS Code to SumUp

For GitHub Copilot, add this configuration to .vscode/mcp.json in your workspace. Merge it with any existing servers:

{
  "servers": {
    "sumup": {
      "type": "http",
      "url": "https://mcp.sumup.com/mcp"
    }
  }
}

Run MCP: List Servers from the command palette, start SumUp, and complete authorization when prompted. Its tools are then available in agent chat.

See the VS Code MCP documentation(Opens in a new tab).

Connect Claude Desktop to SumUp

For a Claude plan that supports custom connectors:

1. Open Customize > Connectors.
2. Choose Add, then Add custom connector.
3. Enter SumUp as the name and https://mcp.sumup.com/mcp as the URL.
4. Complete the SumUp authorization flow and enable the connector in your conversation.

On Team and Enterprise plans, an owner must add the connector before members can connect it. See the Claude custom connector documentation(Opens in a new tab).