Skip to main content

​
Overview

Magnet provides an MCP (Model Context Protocol) server that lets AI coding tools interact with your workspace. This enables tools like Cursor, VS Code, and Claude Code to:
  • Search issues and pages in your Magnet workspace
  • Create and update issues and pages
  • Upload chat sessions from your editor to Magnet
  • Read issue and page content as context

​
Setting up the MCP server

1

Get your API key

Go to Settings > API Keys in the Magnet dashboard and create an API key for your organization.
2

Copy the MCP configuration

In your organization settings, find the MCP Server section. Copy the configuration snippet for your tool.
3

Add to your tool

Paste the configuration into your tool’s MCP settings.

​
Cursor configuration

Add to your Cursor MCP settings (.cursor/mcp.json): 
{
  "mcpServers": {
    "magnet": {
      "url": "https://magnet.run/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

​
Claude Code configuration

Add to your Claude Code MCP settings: 
{
  "mcpServers": {
    "magnet": {
      "url": "https://magnet.run/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

​
Available tools

Once connected, the MCP server exposes these tools to your AI coding assistant:
ToolDescription
searchSearch across issues and pages
list_issuesList issues with optional filters
get_issue_by_idGet a specific issue with full content
create_issueCreate a new issue
update_issueUpdate an existing issue
list_pagesList pages with optional filters
get_page_by_idGet a specific page with full content
create_pageCreate a new page
update_pageUpdate an existing page
upload_chatUpload a chat session from your editor

​
Chat uploads

The MCP server can upload chat sessions from Cursor and Claude Code to your Magnet workspace. This lets you capture important conversations and share them with your team. When you upload a chat, it’s stored in Magnet and accessible from the dashboard — preserving the full conversation including thinking, tool calls, and results.

​
Supported editors

  • Cursor — exports conversation history including tool calls and results
  • Claude Code — exports conversations with full content blocks