# Install Grapp in this coding agent

Grapp is a B2B prospecting app. Its MCP server lets you read the user's pipeline,
campaigns and replies, review the messages about to go out, and prepare campaigns,
on their behalf and within the access they grant.

You are reading this because the user asked you to set Grapp up. Do the steps below
yourself, explain each one in a sentence, and stop to ask the user only where a step
says so.

Server URL: https://app.grapp.ai/mcp
Transport: streamable HTTP. Authentication: OAuth (the user signs in to Grapp in their
browser). There is no API key, client id or secret to ask for — never ask the user for one.

## 1. Add the server

Use the section that matches the agent you are.

### Claude Code

Run:

```sh
claude mcp add --transport http --scope user grapp https://app.grapp.ai/mcp
```

`--scope user` makes Grapp available in every project. If a server named `grapp`
already exists, run `claude mcp remove grapp --scope user` first, then add it again.

### Codex

Run:

```sh
codex mcp add grapp --url https://app.grapp.ai/mcp
```

If that command is not available in this version of Codex, add this to
`~/.codex/config.toml` instead:

```toml
[mcp_servers.grapp]
url = "https://app.grapp.ai/mcp"
```

### Another agent

Add a remote MCP server named `grapp` with the URL above, streamable HTTP transport,
OAuth authentication.

## 2. Sign in

- **Claude Code**: ask the user to type `/mcp`, pick `grapp` and choose *Authenticate*.
  A server added during a session may not show in `/mcp` until Claude Code restarts: if
  the user does not see `grapp`, tell them to quit (`/exit`) and run `claude --continue`
  in the same folder — this conversation resumes, with Grapp loaded.
- **Codex**: run `codex mcp login grapp`.

A browser window opens on Grapp's sign-in page. Tell the user what to expect: they
enter their work e-mail, type the code Grapp e-mails them, then approve the access
levels on the consent screen. Wait for them to say it is done.

If the sign-in page refuses the account, Grapp's assistant access is not open to it
yet: tell the user to contact Grapp support, and stop there.

## 3. Check it works

Call the `grapp_brief` tool and give the user its answer in two or three lines.
Then suggest what they can ask next, for example:

- "What needs my attention today?"
- "What do we know about <a company>?"
- "Show me the messages waiting for my review."
