Skip to main content

Swydo MCP

MCP (Model Context Protocol) is an open standard that lets AI assistants securely connect to external tools and data

When using an MCP to connect an AI assistant to Swydo, the biggest opportunity is to turn the AI into an intelligent reporting assistant that can access client data, analyse performance, identify opportunities, and eventually take action.


How it works

Connecting your AI assistant to Swydo is simple:

1. Connect your AI tool to Swydo

Add Swydo as a custom MCP connector in your AI assistant's settings using the following server URL:

https://ai.swydo.com/mcp

2. Authorise access

Sign in with your Swydo account and approve the connection. No API key or additional configuration is required.

3. Start exploring your data

Ask your AI assistant questions about your reporting data. It can discover available data sources, metrics, dimensions and filters, then retrieve the relevant information to answer your questions.
​

Key benefits

  • Access based on your Swydo permissions: The MCP respects the roles and permissions configured in your Swydo account. You can only access data you're authorised to view.

  • Cross-client analysis: Explore data for an individual client or analyse multiple clients in a single workflow.

  • Flexible data retrieval: Access available metrics, dimensions and filters directly from your connected data sources, rather than being limited to the metrics displayed in existing report widgets.

  • Read-only access: The MCP currently allows you to retrieve and analyse data. It cannot create, edit, or delete anything in your Swydo account.
    ​

How to connect Swydo to your AI assistant

The setup process depends on which AI assistant you're using.
​

Claude

Organisation setup

If you're using Claude for an organisation, an organisation owner must first add the Swydo connector:

  1. Go to Organization settings → Connectors.

  2. Add Swydo as an organisation connector.

  3. Members can then connect their individual Swydo accounts.

Claude Pro and Max

  1. Open Claude and navigate to Customize → Connectors.

  2. Click the + button and select Add custom connector.

  3. Enter Swydo as the connector name.

  4. Paste the Swydo MCP server URL:

    https://ai.swydo.com/mcp

  5. Click Continue and review the authentication details.

  6. Click Add, then Connect.

  7. Sign in with your Swydo account and authorise access.

For more information, visit Claude's guide to custom connectors.
​

ChatGPT

Custom MCP connector support depends on your ChatGPT plan and workspace settings.


Setup instructions

  1. In ChatGPT, go to Plugins.

  2. Click + and select Add custom MCP server.

  3. Name it Swydo, paste the server URL and set Authentication to OAuth.

  4. Review the risk warning and select I understand and want to continue.

  5. Click Create as a plugin and review the tools.

  6. Sign in with your Swydo account when ChatGPT asks.

Still on the older Apps screen?

  1. In ChatGPT, open Settings → Apps and click Create.

  2. Name it Swydo, paste the server URL and set Authentication to OAuth.

  3. Click Scan Tools and sign in with your Swydo account when asked.

  4. Click Create.

For more information, visit OpenAI's guide to custom MCP connectors.

Please note: ChatGPT's interface and connector setup options may vary depending on your plan and workspace configuration.
​

Claude Code

You can connect Swydo directly to Claude Code using your terminal.

Run the following command:

claude mcp add --transport http swydo https://ai.swydo.com/mcp

Follow the authentication instructions to complete the connection.
​

Cursor

To connect Swydo to Cursor, add the following configuration to your Cursor MCP configuration file:

{   "mcpServers": {     "swydo": {       "url": "https://ai.swydo.com/mcp"     }   } }

Save the configuration and follow the authentication instructions to authorise access.
​

Other AI assistants

Any AI assistant or tool that supports custom remote MCP servers can potentially connect to Swydo.

  1. Open the AI tool's MCP, connector or integration settings.

  2. Select the option to add a custom remote MCP server.

  3. Enter Swydo as the connector name.

  4. Add the server URL:

    https://ai.swydo.com/mcp

  5. Select OAuth as the authentication method, if prompted.

  6. Sign in with your Swydo account and authorise access.

The setup process may differ between AI tools. Refer to the relevant provider's documentation for specific instructions.

FAQs

Which AI tools work with the SWydo MCP?
Any AI tool that supports custom MCP connectors, including Claude and ChatGPT. Add the server URL https://ai.swydo.com/mcp as a custom connector and sign in with your Swydo account.
​

Do I need a paid AI plan?
It depends on the AI tool. Claude lets you add a custom connector on all plans, including Free. ChatGPT requires a paid plan with Developer Mode turned on. Check your AI tool’s plan details for the latest availability.
​

Can the AI change my reports?
No. The Swydo MCP is read-only for now. Your AI can retrieve and analyze data, but it can’t create, edit or delete anything in Swydo.
​

Which data can the AI see?
Only the data your Swydo role and permissions allow. Contributors, for example, can only access the clients they already have access to in Swydo.
​

Does it use Swydo AI credits?
No. Questions run on your own AI tool and use that tool’s credits.
​

How is my data handled?
Swydo data is shared only with the AI tool you connect, and only when you ask a question. How that tool stores or processes data depends on its own privacy settings.

Privacy and security

Your privacy and data security are important to us.

The Swydo MCP connector uses your existing Swydo account permissions to determine which data can be accessed. It does not provide access beyond the permissions assigned to your user account.

For more information about how your data is handled when using the Swydo MCP connector, please refer to our Privacy Policy.
​

​Still need help after reading this article?

Please explore our help center further or reach out to our support team (support@swydo.com).

You can also schedule a demo to get an answer to all your questions.

Happy reporting,
The Swydo Team
​
​

Did this answer your question?