All guides 📄 Guide

Connect your Claude

Your own Claude can do the work in this workspace: read a company, write the pitch, prep the call, map who you know, say what to do next, record what happened.

Do you need a token?

What you are connectingHowToken?
claude.aiAdd a custom connectorNo
ChatGPTAdd a custom connectorNo
Claude Codeclaude mcp addYes
Claude Desktopmcp-remote in the config fileYes
Cursor~/.cursor/mcp.jsonYes

claude.ai and ChatGPT connect by their own connector screen. They mint the token themselves and put it on your Claude tile; there is nothing to copy and nothing to paste. Start at From claude.ai or ChatGPT below.

Everything else pastes a token:

  1. Workspace settings → Connect your apps → Your own agent → New token. Label it "Claude", tick what it may do, press Mint.
  2. Press Copy setup for your agent.
  3. Paste it into Claude Code, Cursor or Claude Desktop. It asks which tool you use and wires it up.

The paste carries the server address, your token and the config for each client, so the agent does the rest.

What it can do

ToolWhat it doesCosts
scan_companyReads a company from its website. A reading that failed says why, and is asked again an hour on.A scan from the token's daily budget.
build_pitchResearches a company and writes the pitch in your voice, deliverables included. Several minutes.A run.
prep_for_callA one-page sheet for a call at a named stage. About a minute.A run.
find_warm_pathsWho in your imported network could open the door on a finished pitch.A run.
push_to_crmSends a finished pitch to the CRM your workspace has connected: the company, its people, a deal and a note that cites the sources. Pushing it again updates. With dryRun: true it writes nothing and answers every write the push would make, with the exact payload, so Claude can show you what lands before it lands.A run.
next_stepPaste their reply or your meeting notes. Back comes where the deal stands, the one next step, the message it needs in your voice, and a checklist. About a minute.A run.
tick_stepTicks a line on that checklist.Nothing, ever.
get_pitchOne saved pitch, by id or by company. Says of each deliverable whether it was written, failed (and why) or was never asked for.Nothing.
list_libraryThe index of what is saved: company, score, verdict. Never the pitch itself.Nothing.
job_statusWhere a running job has got to. Done means the whole result, sources included, and, per deliverable, written, failed with the reason, pending or not requested.Nothing.
record_outcomeWhat happened with a company. Every outcome sharpens the next pitch.Nothing, ever.
whoamiWhat the token holds and how much day is left.Nothing, ever.

Long jobs answer with a job id. Your assistant polls job_status until the status is done. A pitch takes several minutes, so it will wait between polls.

next_step reads what is on the company's outcome record (the same notes you see under Outcomes) with what you just pasted on top. Ask it again with only the company a minute later and it answers with the step. Paste what changed to plan afresh; the newest material decides.

push_to_crm needs a CRM connected first; the workspace's owner does that once under Workspace settings → Connect your apps. With none connected the tool says so rather than guessing one.

Every answer carries its sources. A pitch says which pages it read, who it decided the company is, and what compliance found. Nothing is held back that the studio itself would show you.

Which scopes to tick

The paste works with whatever the token holds. For the whole set:

TickTo get
scan:runscan_company
work:runbuild_pitch, prep_for_call, find_warm_paths, push_to_crm, next_step, job_status
library:readget_pitch, list_library
context:writerecord_outcome, tick_step

A token for a colleague's Claude that should read but never spend gets library:read alone.

Wiring it by hand

The server is https://studio.prospektor.ai/api/mcp, streamable HTTP. Send the token as a bearer header.

Claude Code:

`` claude mcp add --transport http prospektor https://studio.prospektor.ai/api/mcp \ --header "Authorization: Bearer psk_…" ``

Cursor, in ~/.cursor/mcp.json:

`` {"mcpServers":{"prospektor":{"url":"https://studio.prospektor.ai/api/mcp","headers":{"Authorization":"Bearer psk_…"}}}} ``

A client that cannot send a header, Claude Desktop among them, goes through mcp-remote:

`` {"mcpServers":{"prospektor":{"command":"npx","args":["-y","mcp-remote","https://studio.prospektor.ai/api/mcp","--header","Authorization: Bearer psk_…"]}}} ``

From claude.ai or ChatGPT

Their connector screens have no box for a token, and need none.

claude.ai:

  1. Settings, then Connectors in the left sidebar, under Customize. On a Team or Enterprise plan an owner adds it once under Organization settings → Connectors, and everyone else presses Connect afterwards.
  2. Press Add at the top right of the Connectors panel and pick the custom-connector option. Prospektor is not in the directory below; that button is the way in.
  3. Paste https://studio.prospektor.ai/api/mcp and press Add. Leave Advanced settings alone; there is no client id or secret to fill in.
  4. Prospektor opens. Signed out, it asks you to sign in and comes back here.
  5. Press Connect.
  6. In a chat, press +, then Connectors, and switch Prospektor on.

ChatGPT: Settings → Apps → Advanced settings, switch on Developer mode, then Add custom connector and the same address. On Plus and Pro, ChatGPT's custom connectors are read-only: it will scan and read your library and refuse to spend a run. Business, Enterprise and Edu get the whole set.

The screen it opens

One screen, one button. It is headed Connect Claude, says It will work in your workspace as you, and shows five boxes with four ticked: read a company, start work that spends a run, read a saved pitch, record an outcome. Take a copy of this workspace out is left unticked; tick it only if you want the app to be able to export. Then Connect, or Not now.

Only the workspace's owner can connect an app; a member gets one sentence naming the owner to ask. A paused workspace says so and connects nothing.

Check it worked

Ask your assistant what is this workspace wired to. It answers with your workspace's name, the token's label and how much of the day is left; the name is the proof it is pointed at the right workspace.

The connection is a token row under Workspace settings → Connect your apps → Claude, labelled with the app's name; the row says when it was last used and how many calls it has made. Revoke stops the app at once. It renews itself every thirty days for as long as it is used.

The same verbs over plain HTTP

Every tool is also a route on /api/v1, for a script or a CRM:

RouteTool
POST /api/v1/pitch · GET /api/v1/pitch?id=…build_pitch · job_status
POST /api/v1/prep · GET /api/v1/prep?id=…prep_for_call · job_status
POST /api/v1/pathsfind_warm_paths
POST /api/v1/crmpush_to_crm
POST /api/v1/next · GET /api/v1/next?company=… · PATCH /api/v1/nextnext_step · tick_step
GET /api/v1/library?id=… or ?company=…get_pitch
GET /api/v1/library[?q=…]list_library

Scans, outcomes, whoami and exports are on the same surface. See API tokens under the workspace help for the day cap and how to revoke.

What it costs

A run from your Claude is a run. A free workspace has its one full pitch, and your assistant meets the same wall you would. Runs past that need a subscription. The token's day cap is 1,000 calls; whoami, record_outcome and tick_step never count.

When something goes wrong

Revoke a token from Workspace settings → Connect your apps → Revoke. Everything holding it stops at once.

More guides

Search every guide →

still stuck

Ask a person.

The Support pill inside the studio answers in seconds and already knows which workspace you are in. If you would rather write, we read every mail.

hello@prospektor.ai

Open the studio ↗