Connect your AI assistant

The Cashfin MCP server uses the Streamable HTTP transport and signs you in with OAuth. Any MCP client that supports remote servers can connect with one URL:

https://storefront.cashfin.africa/mcp

The same URL works for every business. The business is chosen when you sign in (see Choosing your business).

Every OAuth client follows the same sign-in flow: your browser opens Cashfin, you log in, pick the business, and approve the connection. You never paste a password or API key into the assistant.

• Claude.ai and Claude Desktop
• Claude Code
• ChatGPT
• Cursor
• VS Code (GitHub Copilot)
• Windsurf
• Other MCP clients
• Verify the connection
• Disconnect

Claude.ai and Claude Desktop

Custom connectors are available on Claude's paid plans. On Team and Enterprise plans, an organisation Owner may need to add the connector first.

1. Open Settings → Connectors.
2. Click Add custom connector.
3. Enter:
   • Name: Cashfin
   • Remote MCP server URL: https://storefront.cashfin.africa/mcp
4. Leave the advanced OAuth client ID and secret empty, then click Add.
5. Click Connect, then sign in, pick your business and approve in the browser window that opens.
6. In a chat, open the tools menu and make sure Cashfin is enabled.

Approvals

In the connector's settings, set read and draft-editing tools to Always allow and keep publish and the delete tools on Ask. See Publishing.

Claude Code

claude mcp add --transport http cashfin https://storefront.cashfin.africa/mcp

Add --scope user to make the server available in every project instead of only the current one.

Then authenticate:

1. Run /mcp inside Claude Code.
2. Select cashfin and choose Authenticate.
3. Sign in, pick your business and approve in the browser.

Check the connection at any time with claude mcp get cashfin. Remove it with claude mcp remove cashfin.

ChatGPT

Custom MCP connectors require ChatGPT's developer mode, available on Plus, Pro, Business, Enterprise and Edu plans.

1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
2. Go back to Apps & Connectors and click Create.
3. Enter:
   • Name: Cashfin
   • MCP server URL: https://storefront.cashfin.africa/mcp
   • Authentication: OAuth
4. Click Create, then sign in, pick your business and approve.
5. In a chat, enable the Cashfin connector from the tools menu.

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "cashfin": {
      "url": "https://storefront.cashfin.africa/mcp"
    }
  }
}

Open Cursor Settings → MCP, find cashfin and click Connect (or Needs login) to sign in.

VS Code (GitHub Copilot)

From a terminal:

code --add-mcp '{"name":"cashfin","type":"http","url":"https://storefront.cashfin.africa/mcp"}'

Or add it to .vscode/mcp.json in your workspace:

{
  "servers": {
    "cashfin": {
      "type": "http",
      "url": "https://storefront.cashfin.africa/mcp"
    }
  }
}

Start the server from the MCP view or the mcp.json code lens, then complete sign-in in the browser. Use Copilot Chat in Agent mode to call the tools.

Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "cashfin": {
      "serverUrl": "https://storefront.cashfin.africa/mcp"
    }
  }
}

Refresh the MCP list in Cascade and sign in when prompted.

Other MCP clients

Clients that support remote servers with OAuth: point them at https://storefront.cashfin.africa/mcp. Cashfin supports Dynamic Client Registration and Client ID Metadata Documents, so no client ID or secret is needed. See Authentication.

Clients that only run local (stdio) servers: bridge to the remote server with mcp-remote, which handles the OAuth sign-in:

{
  "mcpServers": {
    "cashfin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://storefront.cashfin.africa/mcp"]
    }
  }
}

Clients without OAuth support: use a URL token. It embeds the credential in the URL, so treat it like a password.

https://storefront.cashfin.africa/mcp/ymc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Verify the connection

Ask your assistant:

Use Cashfin to get my shop context.

It should answer with your business name, catalogue summary and storefront address. If it does not, see Troubleshooting.

Disconnect

• In your assistant: remove or disconnect the Cashfin connector.
• In Cashfin: open the storefront builder, go to Integrations → MCP, and revoke the connection under Connections. This stops the assistant immediately, even if it still holds a token.