Integrating Cirkus with AI Assistants (MCP & OAuth)

The Model Context Protocol (MCP) is the bridge that allows AI assistants like ChatGPT and Claude to securely "talk" to your Cirkus data. Once connected, your AI can summarize projects, check tasks and summarise progress using natural language.
It can also combine this data with that from other sources, to power up your work.

1. Setup Guides by Client

ChatGPT (Plus, Team, & Enterprise)

ChatGPT interacts with Cirkus through Developer Mode, which allows it to act as a full MCP client.

1. Enable Developer Mode: In ChatGPT, go to Settings > Apps > Advanced Settings and toggle Developer Modeto ON.

   

2. Add Connector: Go to Settings > Connectors and click Create (next to Advanced Settings).

   
   

3. Configure: * Name: Cirkus

   • MCP Server URL: https://cirkus.com/mcp

   • Authentication: Select OAuth.
     

4. Authorize: Click Connect. You will be redirected to Cirkus to log in and then click to Approve the connection.
   

5. When you are redirected back to chatGPT the connector should be installed
   

6. Use in Chat: Start a new chat, select Developer Mode from the model picker, and ensure the Cirkus connector is toggled on.
   
   

Claude Desktop

1. Go to Settings ->Connectors
   
2. Add Custom Connector
3. Give it a name and add the URL
   MCP Server URL: https://cirkus.com/mcp
   
   
4. Click Add and you will be redirected to a web page to to authenticate to Cirkus 
   
5. Once you have authenticated successfully your connector will be available to use and publish to others in your Enterprise (if you have a workspace)

Cursor & VS Code

1. Open Settings > MCP in your editor.

2. Add a New MCP Server and select SSE (Server-Sent Events) as the transport type.

3. URL: Paste your unique endpoint from the Cirkus MCP page.

4. Login: Follow the browser prompt to authorize.

3. Security & Access Control

• OAuth Protection: You never share your password with the AI. You are simply granting a secure, revocable token.

• Workspace Privacy: The AI can only see data within Workspaces you have joined at the permission level that you have.

?  Tip: If you have multiple Cirkus Workspaces, you can tell the AI: "Only use the 'Creative Team' workspace for this query" to narrow down results.