Skip to main content

​
Prerequisites

Cursor Editor

Download and install Cursor (free tier works)

Node.js 18+

Required for Hub Bridge - check with node --version
What is Hub Bridge? Hub Bridge (@civic/hub-bridge) is a lightweight local proxy that runs on your machine via npx and bridges stdio-only MCP clients to Civic’s remote HTTP endpoint. Use it when your client doesn’t support remote HTTP MCP connections natively. If your client supports HTTP/Streamable HTTP MCP — use that instead (it’s simpler and has no Node.js dependency).Full Hub Bridge setup guide →
Cursor doesn’t support remote HTTP MCP natively, so this setup uses Hub Bridge as the local proxy.

​
Setup Steps

1

Click 'Add to Cursor'

Use the one-click install button below:Add Civic to Cursor
2

Install in Cursor

When Cursor opens, click “Install” to add the Civic MCP server
3

Enable the Connection

Make sure Civic is enabled in Cursor’s MCP settings. If you don’t see it, try disabling and re-enabling it.
4

First-Time Authentication

The first time you use any MCP command, Hub Bridge downloads itself (once, ~30 seconds) and opens a browser window to app.civic.com. Sign in to link the session to your account.If you haven’t set up Civic yet, the onboarding takes about 2 minutes:
1

Create a free Civic account

Go to app.civic.com and sign in with Google, GitHub, or email.
2

Select your MCP servers

During onboarding, choose which services you want your AI to access — GitHub, Slack, Google Workspace, Dropbox, and more. This creates your default toolkit.
3

Get your MCP URL

Your connection URL is the same for every Civic account:
https://app.civic.com/hub/mcp
The URL is not personalized — what makes it yours is authentication. When you connect your client and complete the OAuth flow, Civic links that session to your account and toolkit.

​
Test Your Connection

Try these prompts in Cursor to verify everything works: 
"What MCP servers are available?"
"Show me my connected tools"
"Help me set up GitHub integration"

​
Troubleshooting

Make sure Cursor is installed and try copying this URL manually:
cursor://anysphere.cursor-deeplink/mcp/install?name=Civic&config=eyJjb21tYW5kIjoibnB4IC15IEBjaXZpYy9odWItYnJpZGdlIn0%3D
Install Node.js 18 or later from nodejs.org and restart Cursor.
The Hub Bridge should handle authentication in the chat. If it doesn’t:
  1. Restart Cursor
  2. Try disabling and re-enabling Civic in Cursor settings
  3. Make sure you’re trying to use a tool that requires authentication
  1. Make sure you clicked “Install” when prompted
  2. Check Cursor’s MCP server settings manually
  3. Try the manual setup method below

​
Manual Setup (If One-Click Fails)

If the one-click install doesn’t work, add Civic manually:
1

Open Cursor Settings

Go to Settings → Features → MCP
2

Add New MCP Server

  1. Click + Add New MCP Server
  2. Select transport type: stdio
  3. Enter nickname: Civic
  4. Enter command: npx -y @civic/hub-bridge
  5. Save the configuration
3

Enable and Test

The server should appear in your MCP servers list. Test with: “What MCP servers are available?”

​
Method 2: Via Configuration File

1

Create MCP Configuration File

Create a file called .cursor/mcp.json in your project root directory
2

Add Configuration

Add the following content:
{
  "mcpServers": {
    "civic": {
      "command": "npx",
      "args": ["-y", "@civic/hub-bridge"]
    }
  }
}
3

Restart Cursor

Save the file and restart Cursor. The MCP server will be automatically detected.
4

Test Connection

Test with: “What MCP servers are available?”

​
Managing Your Tools

​
Adding More Tools

You can add new tools directly in your Cursor chat: 
"Connect me to GitHub"
"Add Slack to my available tools"
"I need access to PostgreSQL"
"Show me what tools are available to connect"
This works because Hub Bridge exposes Civic’s Configurator Agent, which handles adding, removing, and configuring MCP servers via natural language. You don’t need to touch app.civic.com directly.

​
Removing Tools

You can disconnect from specific tools directly in chat: 
"Disconnect from Slack"  
"Remove GitHub from my tools"
"What tools do I currently have connected?"
"Stop my access to Dropbox"

​
Removing the MCP Server

To remove Civic completely: Via Settings:
1

Open MCP Settings

Go to Settings → Features → MCP
2

Delete Server

  1. Find “Civic” in your MCP servers list
  2. Click on the server to access its settings
  3. Click Delete or Remove button
Via Configuration File:
1

Edit Configuration

Open your .cursor/mcp.json file
2

Remove Entry

Delete the "civic" entry from the mcpServers object
3

Save and Restart

Save the file and restart Cursor

​
Resources

Hub Bridge Guide

Detailed Hub Bridge setup and troubleshooting

Client Compatibility

Technical details about Cursor’s MCP support

Troubleshooting

Common Cursor connection issues

Get Help

Join our developer community for setup assistance