HOW IT WORKSCONNECT YOUR TOOLS
Connect

Connect your tools to Hark

Pick the AI tool you use below and follow the steps — usually a button or one line. Once connected, every tool reads the same current state and leaves a note when it's done, so the next one picks up where the last left off.

MCP endpoint
https://harkstudio.io/mcp

Sign in to Hark to connect a client. Personal tokens and per-account details live inside the app.

Set up from your repo

Let the agent read your project and file the first project for you.

Already deep in a project? Don't fill anything in by hand. Point your connected agent at the code and let it hand Hark the first project — then keep the one thing it can't know.

Paste this to your agent

Setup prompt
Read this project, then call propose_venture_from_project with a proposed project (title, one-liner, problem, solution, target market) and the build_state as it actually stands (current phase, summary, in progress, next up, blockers, open questions), plus every decision you can see with its rationale.

Then ask me for one constraint or decision that only Hark should know — something not visible in the code — and record it with add_journal_entry as a decision.

One tool call creates the project, its business fields, its Current state and its decisions, and returns the new V-### code.

Prove the handoff

  1. Open a different client — or just start a fresh session in the same one.
  2. Ask: "Call get_agent_brief for V-### and tell me the constraint I recorded."
  3. If it comes back with your constraint, the handoff is real: your decisions survived the switch.

The getting-started card ticks this step off by itself as soon as a brief read arrives from a second client or a fresh session.

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.