03Per-client install
Exact steps, one card per client.
The one-sentence prompt on the home page usually just works — your AI detects its own client and installs Pairoa. Here's every client spelled out: the MCP IDEs, ChatGPT (which connects a bit differently), and a manual fallback. Copy the card for your client, or hand this page to your AI when it gets stuck.
CCClaude CodeYour AI does it for youAnthropic's terminal-native coding agent
Install Pairoa MCP for me — I'm in Claude Code.
Server URL: https://mcp.pairoa.com
Use `claude mcp add --transport http pairoa https://mcp.pairoa.com`
if that command exists in my version; otherwise write the server entry
into my `.mcp.json` directly. After installing, restart or reload the
MCP session so the tools register.
When you're done, list the new tools (publish_need, poll_matches,
manage_need, decline_match, claim_account) to confirm Pairoa is up.
Then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is connected — 5 tools registered. Ready to publish your first need?Trouble? → pairoa.com/install/claude-code
CUCursorYour AI does it for youAI-native code editor
Install Pairoa MCP for me — I'm in Cursor.
Server URL: https://mcp.pairoa.com
Write the server into `~/.cursor/mcp.json` under the `mcpServers` key.
The entry should look like:
"pairoa": { "type": "streamable-http", "url": "https://mcp.pairoa.com" }
After saving, prompt me to reload Cursor (Cmd+Shift+P → "Reload Window")
so the MCP server picks up.
When you're done, list the new tools to confirm Pairoa is registered,
then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is in your Cursor MCP — reload and the tools appear in Composer.Add to Cursor (1-click)Trouble? → pairoa.com/install/cursor
CLClineYour AI does it for youAutonomous coding agent inside VS Code
Install Pairoa MCP for me — I'm in Cline inside VS Code.
Server URL: https://mcp.pairoa.com
Open the Cline MCP settings (the "MCP Servers" panel in Cline's sidebar,
or via VS Code settings.json under `cline.mcpServers`) and add:
"pairoa": { "type": "streamable-http", "url": "https://mcp.pairoa.com" }
Save, then reconnect Cline (or restart VS Code if needed).
When you're done, list the new tools to confirm Pairoa is registered,
then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is in your Cline MCP servers — five new tools are live.Trouble? → pairoa.com/install/cline
WSWindsurfYour AI does it for youCodeium's agentic IDE
Install Pairoa MCP for me — I'm in Windsurf.
Server URL: https://mcp.pairoa.com
Write the server into `~/.codeium/windsurf/mcp_config.json` under the
`mcpServers` key:
"pairoa": { "type": "streamable-http", "url": "https://mcp.pairoa.com" }
After saving, prompt me to reload Windsurf so the MCP server picks up.
When you're done, list the new tools to confirm Pairoa is registered,
then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is in your Windsurf MCP — reload and the tools are available to Cascade.Trouble? → pairoa.com/install/windsurf
VSCVS CodeYour AI does it for youVS Code's built-in MCP (Copilot agent mode)
Install Pairoa MCP for me — I'm in VS Code.
Server URL: https://mcp.pairoa.com
Add the server to VS Code's MCP config — a `.vscode/mcp.json` in my
workspace (or the user-level mcp.json). VS Code uses a `servers` key
and `"type": "http"`:
{
"servers": {
"pairoa": { "type": "http", "url": "https://mcp.pairoa.com" }
}
}
After saving, reload VS Code (or press Start on the server in the MCP
view) so the tools register.
When you're done, list the new tools to confirm Pairoa is registered,
then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is in your VS Code MCP — reload and the tools appear in agent mode.Add to VS Code (1-click)Trouble? → pairoa.com/install/vscode
CXCodex CLIYour AI does it for youOpenAI's terminal coding agent
Install Pairoa MCP for me — I'm in Codex CLI.
Server URL: https://mcp.pairoa.com
Add Pairoa to my Codex config (~/.codex/config.toml) through a local
bridge. Codex's native remote/OAuth MCP support is unreliable — it often
authenticates but never surfaces the tools — so run the server through
mcp-remote, a tiny local stdio bridge that handles the OAuth for you:
[mcp_servers.pairoa]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.pairoa.com"]
Don't configure Codex with a bare url for Pairoa — that path drops the
tools. After editing the config, FULLY QUIT AND REOPEN the Codex app
(Cmd-Q, not just a new chat) so it loads the bridge. On first use a
browser opens for the OAuth sign-in — click Connect (anonymous, no
signup). mcp-remote caches the token and refreshes it automatically, so
Pairoa stays connected.
If you don't see Pairoa's tools after the restart, run `codex mcp
list` to confirm pairoa is enabled, and make sure `npx` is on your PATH.
When you're done, list the new tools to confirm Pairoa is registered,
then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is wired into Codex — restart and you'll have 5 new tools.Trouble? → pairoa.com/install/codex
CDClaude DesktopYour AI walks you through itThe official Claude app for macOS & Windows
Install Pairoa MCP for me — I'm in Claude Desktop.
Server URL: https://mcp.pairoa.com
The reliable way — no download, nothing to break. Pairoa is a remote
connector, so it's added through Claude's Connectors UI (not a config
file). You only do this once: Claude syncs connectors across Desktop,
Cowork, web, and mobile.
This is my job, not yours: adding a connector is a one-time action in
Claude's own Settings that only I can do. Do NOT use computer-control,
screen-automation, or browser-clicking tools, and do NOT screenshot my
screen to click through it — just show me these steps and I'll click them:
1. Open this link → https://claude.ai/settings/connectors?modal=add-custom-connector
(or, inside the app: Settings → Connectors)
2. If the box isn't already open, click "Add custom connector"
3. Name: Pairoa URL: https://mcp.pairoa.com → Add
(leave the optional OAuth Client ID/Secret blank)
4. The first tool call opens Pairoa's authorization in my browser —
I just click "Connect" (you go in anonymously — no key, no signup),
then come back.
Do NOT put this in claude_desktop_config.json — that file is only for
local servers, and writing a remote url there can silently wipe my
other MCP servers. Remote server = Connectors UI.
When I'm back, list the new tools (publish_need, poll_matches,
manage_need, decline_match, claim_account) to confirm Pairoa is connected.
Then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is added as a connector — click Connect on the first tool call and it works across all your Claude apps.Trouble? → pairoa.com/install/claude-desktop
Add it once — Claude syncs the connector to Desktop, Cowork, web, and mobile.
CaiClaude.aiYour AI walks you through itClaude in the browser (Free and up)
Install Pairoa MCP for me — I'm in Claude.ai (the web app).
Server URL: https://mcp.pairoa.com
You don't have local file access from Claude.ai, and adding a connector
is a one-time action in Settings that only I can do — so do NOT use
computer-control, screen-automation, or browser-clicking tools, and do
NOT screenshot my screen. Just give me the link to open and the values
to fill, and I'll do it myself:
1. Open this link → https://claude.ai/settings/connectors?modal=add-custom-connector
2. If the box isn't already open, click "Add custom connector" (label may say "Browse" or "Add MCP"
— pick whichever leads to a URL input).
3. Name: Pairoa URL: https://mcp.pairoa.com → Add
(leave the optional OAuth Client ID/Secret blank)
4. The first tool call opens Pairoa's authorization — I click "Connect"
to go in anonymously (no key, no signup), then come back.
When I'm back, list the new tools (publish_need, poll_matches,
manage_need, decline_match, claim_account) to confirm Pairoa shows up
in this conversation, then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.
Note: custom connectors work on every Claude plan — Free, Pro, Max,
Team, Enterprise — though Free is limited to one custom connector. No
need to upgrade just for this.✓When it works, your AI says:
Pairoa is in your Claude.ai connectors — click Connect and the tools appear here.Add to Claude.ai (1-click)Trouble? → pairoa.com/install/claude-ai
GPTChatGPTCustom GPT · or Enterprise MCPOpenAI's chat client — MCP on Business/Enterprise, Custom GPT for everyone else
Install Pairoa for me — I'm in ChatGPT.
Pairoa MCP server: https://mcp.pairoa.com
Pairoa GPT for regular ChatGPT users:
https://chatgpt.com/g/g-6a253afdb4988191bb093c83d98d82a9-pairoa
Pairoa OpenAPI schema for Custom GPT builders: https://pairoa.com/api/openapi
Setting this up is a one-time step I do in ChatGPT's own Settings — so do
NOT use computer-control, screen-automation, or browser-clicking tools, and
do NOT screenshot my screen. Just give me the path and I'll click it.
Pick the path that matches my plan:
(A) Business / Enterprise / Edu workspace: use ChatGPT Apps / remote MCP.
Full/write-capable MCP apps are available for these workspace plans,
not for individual Plus / Pro.
In Workspace Settings, enable
Developer mode (Apps — OpenAI renamed "Connectors" to "Apps"), then
create a custom MCP app and give it the MCP URL above → click
Connect to authorize (anonymous; no key).
(B) Individual Plus / Pro, or anyone who just wants to use Pairoa in
ChatGPT: open the Pairoa GPT link above. It uses Actions / OpenAPI
behind the scenes, and ChatGPT asks you to authorize Pairoa when the
first action runs. No client_id or client_secret is needed.
(C) Builders creating their own Custom GPT: use Actions (OpenAPI).
In the GPT builder, add an Action → Import from URL →
https://pairoa.com/api/openapi . Set Authentication to OAuth:
Authorization URL: https://pairoa.com/oauth/authorize
Token URL: https://pairoa.com/api/oauth/token
Scope: mcp
After ChatGPT shows the callback URL, create/register a Pairoa OAuth
client for that callback URL, then paste the returned client_id and
client_secret into the GPT action. This is a builder/admin step, not
something ordinary Pairoa GPT users do.
When you're done, confirm the path you installed:
- MCP app: Pairoa tools include publish_need, poll_matches, manage_need,
decline_match, and claim_account.
- Pairoa GPT / Custom GPT Action: Pairoa actions include publishNeed,
pollMatches, editNeed, closeNeed, declineMatch, sendContactCode,
and verifyContactCode.
Then walk me through publishing my first need.
What Pairoa does: a private matching market — I describe what I'm
looking for and what I can offer, and only get back contact info
when an LLM judge finds a mutual fit.✓When it works, your AI says:
Pairoa is set up — try "I'm looking for a co-founder, here's what I'm building".Trouble? → pairoa.com/install/chatgpt
Two user paths: workspace Apps/remote MCP for Business/Enterprise/Edu teams that can enable write-capable MCP, and the Pairoa GPT for everyone else. The OpenAPI schema is for builders creating a Custom GPT.
Other MCP clientsManual JSON
Self-built clients, or older versions without deep-link support.
If your client speaks MCP but isn't in our list above, add this server
entry to your client's MCP config (path varies by client):
{
"mcpServers": {
"pairoa": {
"type": "streamable-http",
"url": "https://mcp.pairoa.com"
}
}
}
Use your client's current field for a remote HTTP server if it differs
(commonly "type": "streamable-http" with "url"; some clients just take
"url"). Reload your client. The first tool call opens Pairoa's authorization
in a browser — click Connect to authorize (anonymous, no key), and you're in.
Heads up: if you're reading this, your client is off our supported
list. We recommend going back up and trying the "tell your AI" prompt
for whatever client you're in — it'll usually figure it out.Full reference → pairoa.com/install/manual
Still can't get the MCP in?
No client required — sign up and publish straight from the browser.