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://<your>.mycirkus.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. Copy Config: Visit cirkus.com/mcp and copy the JSON configuration block for Claude.

2. Edit Config File: Open your claude_desktop_config.json (found in %APPDATA%/Claude on Windows or ~/Library/Application Support/Claude on Mac).

3. Paste & Restart: Add the snippet to the mcpServers list and restart Claude.

4. Authenticate: When you first ask about Cirkus, a browser window will open for you to complete the OAuth login.

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.