Claude Code MCP phone receptionist
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, 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. 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. 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 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.