# Connect Hark — Claude Code (CLI)

1. In a terminal:

```
claude mcp add --transport http hark https://harkstudio.io/mcp
```

Add --scope user to make it available in every project, or --scope project to share it via .mcp.json with teammates.

1. Start a session: claude. On first tool use a browser tab opens — sign in with your Hark account, then approve on the consent screen.
2. Check: claude mcp list should show hark as connected. Inside a session, /mcp shows status.

First prompt to try: "Use Hark to list my workspaces, then create a project called Test in <workspace>."

## 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.