# Claude Code MCP phone receptionist

> Claude Code MCP adds RingKit's phone server with one command. Here is that command, where the key is stored, and the first tool to call.

Published 2026-11-15 · by RingKit · tags: ai receptionist, setup. Canonical: https://www.ringkit.com/blog/claude-code-mcp

Claude Code MCP, for this phone server, is one command. It tells Claude Code where RingKit's tools are, and it puts an API key on the connection. The product docs give the line. Anthropic's [Claude Code MCP page](https://code.claude.com/docs/en/mcp), opened 15 November 2026, shows the same shape: `claude mcp add --transport http`, a name, a URL, and an optional `--header` for a bearer token. RingKit's URL is `https://api.ringkit.com/mcp`.

```
claude mcp add --transport http ringkit https://api.ringkit.com/mcp --header "Authorization: Bearer rk_…"
```

Replace `rk_…` with a key you already hold. If you do not have one yet, do not invent one and do not paste a placeholder. Skip the header, run the one tool that works without it, and add the server again. Run the command in the project the local config should belong to. The rest of this page is that sequence, where the secret ends up, and the two setups this command is not.

## The command writes a local config

On that Anthropic page, `claude mcp add` stores the server in local scope unless you pass `--scope`. Local means you, in the current project. `--scope user` is you, in every project. `--scope project` writes `.mcp.json` at the project root, which is the file you would commit so other people get the same server.

Do not pass `--scope project` with a live key in `--header`. That file is shared. A key in it is a key in git. The shell also keeps the command in its history, so the header is not a hiding place. Prefer local or user scope, and treat the machine you ran it on as the place the secret lives. A successful add prints an `Added` line. That line means the config was written. It does not mean a call has been answered.

If you would rather edit JSON, the same page says an entry with a `url` and no `type` is skipped. Claude Code reads a missing type as a local stdio server. Add `"type": "http"` on a handwritten entry. The `claude mcp add --transport http` command is the path that sets the transport for you. The JSON block in the RingKit docs that has a `url` and no `type` is the block for Cursor and other clients. Do not paste that block into Claude Code and expect it to load.

## No key yet, then a key

`ringkit_create_business` is the tool that runs with no `Authorization` header. Add the server once without `--header`, ask Claude Code to create the business, and stop. The tool returns the business id and the API key. The key is shown once. Copy it into a password store before the next sentence. The body needs a name, an IANA timezone, and the owner's email. Leave `ownerPhone` off. Create refuses it with `403 destination_unverified`, because a business that does not exist yet cannot have proved it controls a phone.

Then remove the header-less server and add it again with the key. Every later tool needs that header. Every tool result includes a `next` field naming the tool that usually follows. Errors are JSON, `{"error":{"code","message","hint","docs"}}`. Do what `hint` says. Do not retry a failed create with a new story and a new idempotency key. Mutating tools take an optional `idempotencyKey`. The same key returns the stored result. A new key means you meant a new business.

The key you just received is scope `manage`. It acts as the owner. A reporting session does not need it. `ringkit_create_api_key` with `scope` set to `read` makes a key that can GET and nothing else. A read key that tries to change the brief gets `403 insufficient_scope`. Use the manage key for setup. Use a read key if this Claude Code install will only look at calls afterward.

## The first tools, then stop

After the key is on the connection, `ringkit_whoami` tells you which business the key opens. `ringkit_get_onboarding` tells you what is still empty. Teaching is next: `ringkit_start_knowledge_import` with the client's site, or `ringkit_put_knowledge` if there is no site. Read the profile before you trust it. An import fills empty fields. It does not replace a price a person already typed, and a homepage can list a sale that ended.

`ringkit_put_routing` is where you name the business's own phone numbers and when to transfer. `mode` is `ai_only`. The receptionist answers. RingKit does not put a person on the line. If no rule matches, it takes a message. The full tool table, in the order `tools/list` uses, is [MCP phone receptionist](https://www.ringkit.com/blog/mcp-phone-receptionist). This page stops at the command and the key. That one is the sequence.

Do not order the number in the same breath as create. Ordering needs $2 of paid credit in the wallet. There is no free trial. `ringkit_top_up` returns a checkout URL. A person opens it and pays. The smallest top-up is $10. The number is $1.99 a month. Talk time is $0.20 a minute, the first 10 seconds free, then billed in 6-second increments. A text simulation is billed the same way. Do not tell anyone the simulation is free.

## This is not the claude.ai connector

Claude Code and the Claude chat app are different clients. The custom connector in claude.ai uses `https://api.ringkit.com/mcp/oauth`, and the owner approves it in a browser. That setup is [Add a Claude phone connector](https://www.ringkit.com/blog/claude-phone-connector). It does not use `claude mcp add`, and it does not take an API key in the URL. If you follow the connector steps here, you are in the wrong article. If you paste an API key into the chat app, you have put a secret in a transcript.

`/mcp` inside Claude Code, the command on this page, is the bearer-token server. The product [docs](https://www.ringkit.com/docs#agents) still show both, on purpose. Match the client you actually have open. Anthropic's page recommends HTTP for a remote server and marks the older SSE transport as deprecated. RingKit's docs say this server speaks Streamable HTTP and takes POST only, so the flag stays `--transport http`, not `--transport sse`. The command is also per machine. The connector approval is per person, in a browser, for one business. Setting one up does not configure the other.

## What you still hand to a person

Two steps are not tool calls you can finish alone. Someone pays the checkout URL. Someone answers `ringkit_verify_destination`, hears a 6-digit code, and tells you the code so you can confirm it. That code is their consent to be called. Then `ringkit_test_call` rings that verified number. Your session cannot hear the code.

The receptionist always says it is an AI. Calls are recorded and transcribed so the summary can be written, and a consent notice plays on every call. There is no SDK. There is no calendar booking tool in this server. A caller who asks for a time becomes a message, or a transfer to a number you listed. The optional last step is `ringkit_invite_owner`, which emails a sign-in link. The line can run before they open it. When they do, they can revoke the key you put in the header. Plan on that. A key in a local Claude Code config is a key you should be able to throw away.

---

Try Ringkit: $0.20/min, $1.99/mo per number, no plan. Get started at https://app.ringkit.com/onboard
