Skip to main content

​
Prerequisites

Cursor Editor

Download and install Cursor (free tier works)

Node.js 18+

Required for the Hub Bridge - check with node --version

​
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, the Hub Bridge will:
  • Automatically download and install itself
  • Handle authentication directly in the chat interface
  • Let you select which tools to connect from nexus.civic.com

​
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"
Cursor will handle the connection process and guide you through any required authentication steps.

​
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