Connecting Claude Code to WhatsApp Business takes 5 minutes with Aurora MCP. Aurora exposes an MCP server in https://developers.aurorainbox.com/mcp With 30+ tools (search chats, send messages, create contacts, move opportunities through the funnel, launch webhooks) that any MCP-compatible agent can use. All you need is an Aurora Inbox workspace and a key. ak_live_* from the Developer Portal and a command Claude MCP AddThis guide covers the setup from start to finish.
Prerequisites
Before running the command, make sure you have:
- Aurora Inbox Workspace active (the free trial It is used to test the entire flow).
- WhatsApp Business number connected in Aurora (via OAuth with Meta or manual registration).
- Claude Code installed (
npm install -g @anthropic-ai/claude-codeor the official installer). - Key Platform API
ak_live_*generated in the Developer Portal (below).
Step 1: Generate the Aurora key
- Enter your workspace at
app.aurorainbox.com. - Go to Integrations → Developer Portal (Direct URL: https://app.aurorainbox.com/integrations/developer-portal).
- Click on Generate new keyGive it a descriptive name (e.g.
claude-code-laptop-alex). - Copy the key — it starts with
ak_live_…It is only displayed once; if you lose it, you must generate another one.
The key is scoped to a single tenant (an Aurora workspace) with scope aurora.api.platformAny action that Claude Code performs is done with your workspace identity and is recorded in the audit log.
Step 2: Add Aurora MCP to Claude Code
A single command:
claude mcp add aurora \ --transport http \ https://developers.aurorainbox.com/mcp \ --header "Authorization: Bearer ak_live_REEMPLAZA_TU_CLAVE"
This adds Aurora to your user configuration (~/.claude.jsonTo verify that it was registered:
Claude MCP list
You should see Aurora in the list with status connectedIf it appears failedCheck that the key is complete and starts with ak_live_.
Step 3: Test the connection
Open Claude Code in any project and ask it for something simple:
> List the first 5 contacts from my Aurora Inbox account.
Claude Code is going to call the tool list_contacts and return an array with id, yam, phone, e-mail, companyNameIf the response arrives, the setup works.
What tools does Aurora MCP offer?
Aurora MCP covers all 10 functional areas of the product. Each tool mirrors a Platform V1 API REST endpoint 1:1.
| Category | Representative tools | Use case |
|---|---|---|
| Chats | search_chats, get_chat, create_chat, assign_chat_agents, set_chat_owner |
Tray triage, agent assignment |
| Messages | send_message (1 ms/sec per tenant), internal notes with note=true |
Responses, follow-ups, and feedback for the team |
| Chatbots | start_chatbot, stop_chatbot, list_chat_chatbots, list_chatbots |
Activate workflows in specific chats |
| Contacts | list_contacts, get_contact, create_contact, update_contact, upsert_contact, delete_contact |
Basic CRM from the agent |
| Companies | list_companies, get_company, create_company, update_company |
B2B Accounts |
| Opportunities | create_opportunity, update_opportunity, delete_opportunity, list_chat_opportunities |
Moving deals through the funnel |
| Channels | List and review the status of WhatsApp Cloud API, WhatsApp Business, Messenger, and Instagram. | Multi-channel diagnostics |
| Equipment / Users | Team and User tools for inviting, assigning, and querying | Programmatic onboarding |
| Webhooks | create_webhook, list_webhooks, delete_webhook (max. 5 per tenant) |
Outbound events to your infrastructure |
| Diagnosis | health, whoami |
Validate connectivity and permissions |
The ChannelType that accept create_chat and related endpoints are: 0=WhatsApp Cloud API, 1=WhatsApp Business, 2=Messenger, 3=Instagram.
Three example end-to-end prompts
Morning triage
Search Aurora for all unanswered WhatsApp chats from the last 24 hours. For each one, read the customer's last message and give me a one-line summary and the priority (high/medium/low) based on whether it mentions money, urgency, or a complaint.
Claude Code calls search_chats(unanswered=true) and then get_chat(id) for each one. You get a prioritized list in natural language.
Make contact and open opportunity
I have a new lead: Daniel Martínez, +52 55 1234 5678, daniel@empresa.mx, Company "Logística MX". Create him in Aurora and open an opportunity in the "Q3 Sales" funnel of the sales team with an estimated amount of $80,000 MXN.
Claude Code chains upsert_contact → create_chat (WhatsApp Cloud channel) → create_opportunity → update_opportunity(dealAmount=80000)All within the chat session without you having to open the Aurora UI.
Massive follow-up
Look for chats in the "no customer response" status that are older than 72 hours. Send each one a short, friendly follow-up message asking if they still need help. Wait 1 second between messages to respect the rate limit.
Claude Code automatically respects the rate limit of send_message (1 message/second per tenant — if it exceeds this, it receives Rate limit exceeded… retry after 1s and stops).
Troubleshooting
Error 401 Unauthorized
The key was not pasted completely or has gaps. Regenerate and paste it carefully. The key must start exactly with ak_live_.
Error 403 Forbidden in specific tools
Some tools require additional roles (e.g. delete_contact (requires the Contact Administrator role). Check the user roles associated with the key in Integrations → Developer Portal → Permissions.
The tools do not appear in Claude MCP list
Restart Claude Code (Ctrl+C and Claude again). If it persists, run curl https://developers.aurorainbox.com/.well-known/mcp.json and verify that the server responds.
Rate limit in send_message
Aurora limits sending to 1 message per second per tenant to protect number quality in Meta. If your agent wants to send 100 messages, sequence them with a 1-second delay or use the endpoint /Platform/V1/Messaging/Bulk (not exposed via MCP by design).
How Aurora MCP does it
Unlike attaching the WhatsApp Cloud API endpoint directly to an agent, Aurora MCP provides:
- Simple Auth: a key
ak_live_*It reuses the same Platform API system you already had. No three-legged OAuth, no expiring tokens. - Native audit logEach call is recorded in Aurora with the
keyIdthat originated it. - Rate limits per tenantYour agent cannot degrade the quality of the Meta number by sending too quickly.
- Multi-channelThe same tool works for WhatsApp Cloud, WhatsApp Business, Messenger, and Instagram — the agent chooses the channel with
channelType. - CRM behindEach chat is already linked to a contact and can generate opportunities — it's not just "send a message".
Recommended plan to start with: Aurora IA $179 USD/month ($3,200 MXN) which includes GPT-5, native RAG, onboard scheduling and MCP server.
Start your free trial and connect Claude Code in 5 minutes.
Frequently Asked Questions
Is Aurora MCP free?
The MCP server is included in any paid Aurora Inbox plan (CRM $99 USD, IA $179 USD, IA Plus $329 USD). The 14-day trial also includes it without restriction.
Does it work with Claude Code in CLI mode and in IDE mode (VS Code/JetBrains)?
Yes. The configuration remains in ~/.claude.json and applies to all Claude Code surfaces.
Is my key visible in Claude Code logs?
Claude Code masks headers Authorization in its debug log. Still, it tries ak_live_* as password — don't commit it to git.
Can I give you one key per agent or per developer?
Yes, recommended. It generates one key per human and one per machine; it revokes keys individually from the Developer Portal without affecting the others.
Does it support multi-tenant?
Each key is scoped to one tenant. If you manage multiple Aurora workspaces, generate one key per workspace and add them with distinct names: claude mcp add aurora-prod … and claude mcp add aurora-staging ….
What happens if Anthropic updates the MCP protocol?
Aurora supports version 2025-03-26 (the stable spec of Anthropic) on transport streamable-httpFuture versions will be added while maintaining backward compatibility according to the official spec.
Can I connect other agents (Codex, Cursor, Claude Desktop) to the same Aurora?
Yes. Same key, same endpoint. Each client has a slightly different setup—check our guides for Codex CLI, Claude Desktop, Cursor and VS Code Copilot.
