Who is This For?
This guide is for:
Cursor users
Cline (VS Code extension) users
Any tool that supports stdio MCP servers
Developers comfortable editing JSON files
Before You Start
Get Your API Key
1. Open Intangle web app
2. Click "External Connections" in the sidebar
3. Click "Local MCP"
4. Click the copy button next to your API key OR mcp json string
**Keep this private** - it's like a password!
Configuration Steps
Step 1: Find Your Config File
The location depends on your tool:
Cursor:
- Mac: `~/.cursor/config.json` or `.cursor/config.json` in your project
- Windows: `%USERPROFILE%\.cursor\config.json`
- Linux: `~/.cursor/config.json`
Cline (VS Code):
- Check the Cline documentation for the specific config file location
- Usually `mcp.json` in your VS Code settings
Other MCP clients:
- Look for `mcp.json` or similar configuration file
- Check your tool's documentation
Step 2: Create or Edit the Config File
If the file doesn't exist, create it. If it exists, add to the `mcpServers` section.
Step 3: Add This Configuration (if you didn't copy JSON for some reason)
{
"mcpServers": {
"intangle": {
"command": "npx",
"args": ["-y", "@intangle/mcp-server"],
"env": {
"MCP_API_KEY": "YOUR-API-KEY-HERE",
"NEXT_APP_URL": "https://intangle.app"
}
}
}
}
Important: Replace `YOUR-API-KEY-HERE` with your actual API key!
Step 4: Save and Restart
Sometimes you don't need to restart, but if not:
1. Save the config file
2. Restart your editor completely (not just reload window)
3. The MCP server will start automatically
Verify Your Connection
In your editor's AI assistant, ask:
> "Can you list my Intangle spaces?"
If it responds with your space names, you're connected!
How to Use It
Talk naturally to your editor's AI assistant:
Saving information:
- "Remember that the API endpoint is https://api.example.com/v1"
- "Save to my Work space: The database connection string is in .env.local"
- "Create a task to add error handling to the payment flow"
Searching your memory:
- "What do I have in Intangle about authentication?"
- "Search my work space for deployment procedures"
- "Show me my pending tasks"
Viewing your spaces:
- "What Intangle spaces do I have?"
- "List my topics in the Work space"
Example: Full Config File
Here's what a complete config file might look like (you can have multiple MCP servers):
{
"mcpServers": {
"intangle": {
"command": "npx",
"args": ["-y", "@intangle/mcp-server"],
"env": {
"MCP_API_KEY": "mcp_user_abc123_xyz789",
"NEXT_APP_URL": "https://intangle.app"
}
},
"another-server": {
"command": "python",
"args": ["path/to/server.py"]
}
}
}
Troubleshooting
AI assistant says it doesn't have access to Intangle
1. Verify your API key is correct (no extra spaces or quotes)
2. Check the config file is in the right location
3. Make sure you restarted your editor (not just reloaded)
4. Look for error messages in your editor's console/logs
The MCP server isn't starting
Check that:
- Node.js is installed (`node --version`)
- npx is available (`npx --version`)
- The config file JSON is valid (no syntax errors)
Connection works sometimes but not always
The MCP server might be crashing. Check:
- Your editor's console/logs for error messages
- That your API key hasn't been rotated
- That you have internet connectivity
Want to use a different API key?
1. Generate a new API key in Intangle
2. Update the `MCP_API_KEY` value in your config file
3. Restart your editor
Still stuck?
Contact Support and include:
- Which tool you're using (Cursor, Cline, etc.)
- Your config file (with API key redacted!)
- Any error messages from your editor's console
Next: