# Connect Cursor

> **Release status.** The hosted endpoint, OAuth, curated operator tools, toolset endpoints and the send permission are live.

Add Masheev to `.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "masheev": {
      "url": "https://api.masheev.com/api/agents/mcp"
    }
  }
}
```

Open **Cursor Settings → MCP**. Masheev shows **Needs login**; choose it and complete the Masheev sign-in in your browser. Pick one workspace and the permissions to grant.

For a headless or shared setup, use an agent key from **Developers → Connect an agent** as a header, sourced from an environment variable rather than written into the file:

```json
{
  "mcpServers": {
    "masheev": {
      "url": "https://api.masheev.com/api/agents/mcp",
      "headers": { "Authorization": "Bearer ${env:MASHEEV_API_TOKEN}" }
    }
  }
}
```

Coding tasks that need the full catalog can use `https://api.masheev.com/api/agents/mcp/x/all`. Cursor works best with a few dozen tools; prefer the default endpoint or a single toolset.

See [Connect an agent](https://docs.masheev.com/agents.md) for permissions and revocation.