# Connect Hark — Cursor (editor and CLI)

1. Cursor Settings → Tools & MCPs → Add Custom MCP (or edit ~/.cursor/mcp.json; use .cursor/mcp.json inside a repo to scope it to that project). Add:

~/.cursor/mcp.json:

```
{
  "mcpServers": {
    "hark": {
      "url": "https://harkstudio.io/mcp"
    }
  }
}
```

1. Back in Settings, find hark and click Connect / Needs login — sign in and approve.
2. From the Cursor CLI: agent mcp login hark does the same.

## Verify it works

Ask your client: "List my Hark workspaces." Expected: your workspace names.

Then: "Create a project called Connection test in <workspace>." Expected: a new V-### appears in the app and the activity log shows the source ("via Claude Code", "via Codex", etc.). Delete the test venture afterward.

## Troubleshooting

- "Unauthorized request origin" — the client origin isn't allowlisted; retry from the latest app version, or email hello@harkstudio.io.
- Consent screen loops / stale token — remove the connector in the client, sign out of Hark, sign back in, re-add the connector.
- Tools list is empty — the connector isn't enabled for this chat (Claude and ChatGPT require enabling it per conversation).
- Plan cap error — you've hit the monthly agent-call cap for this workspace; see billing.
- Old endpoint — anything pointing at a lovable.app URL must be updated to harkstudio.io/mcp.