Connect Claude Code to Your Studio
What it is
Section titled “What it is”Claude Code is Anthropic’s Claude, which runs in your computer’s terminal. With the AI connector, it can look up your studio’s data (sales, clients, schedule, and finances) when you ask, using the permissions of the user associated with the key. It only looks up information; it doesn’t change anything in the system.
When to use it
Section titled “When to use it”- You already use Claude Code on your computer and want to ask about your studio’s activity without leaving it.
- You want to create a summary or spreadsheet using system data, with a request in plain language.
Before you start
Section titled “Before you start”Have the connector address ready. Copy it as described in the Connect your AI article. Claude Code must be installed on your computer. You can sign in with your system login; an API key is optional if you prefer not to use your login (for example, on a computer without a browser).
Step by step
Section titled “Step by step”Step 1 — Add the connector
Section titled “Step 1 — Add the connector”In your terminal, run the command below, replacing the address with the one you copied using Copy address:
claude mcp add --transport http heya https://seu-dominio/mcpIn Claude Code, type /mcp, choose heya, then select the authentication option. The system login page opens in your
browser. Sign in, choose the Company, and click Authorize.
If you prefer to use an API key (created with Allow use as AI connector), add the header to the
command: --header "Authorization: Bearer hk_...".
To use the connector in every folder on your computer, instead of just the current folder, add
--scope user to the command.
Step 2 — Check the connection
Section titled “Step 2 — Check the connection”Run claude mcp list. The heya connector should appear as connected. In Claude Code, the
/mcp command shows the same status.
Step 3 — Ask a question
Section titled “Step 3 — Ask a question”Open Claude Code and ask something like, “How much did I sell at the studio yesterday?” The first time, Claude may ask you to approve its use of the connector’s tools.
What happens next
Section titled “What happens next”- Claude finds the right query for your question, runs it, and responds with data from the system.
- The key appears in the API Key tab, with Last used updated.
- To revoke access, revoke the key in the API Key tab. Claude Code will lose access within 30 seconds.
Common mistakes and questions
Section titled “Common mistakes and questions”Q: claude mcp list shows “Failed to connect.” What should I do?
A: Check that the address ends in /mcp and that you pasted the entire key, including Bearer and a space after it.
The command saves the configuration without testing the key, so an error only appears when Claude tries to connect.
Q: Claude says the key needs “Allow use as AI connector.” Why? A: The key was created without that option. Edit the key in the API Key tab and select Allow use as AI connector.
Q: How do I change the key?
A: Remove the connector with claude mcp remove heya, then add it again with the new key.
Q: Can I share the configuration with my team through our repository?
A: Don’t put the key in a shared file (--scope project saves it to .mcp.json). Each person should
use their own key, with their own user permissions.
Q: Claude said it couldn’t find information that I can see in the system. Why? A: The user associated with the key doesn’t have access to that screen, or the information is excluded from the connector for security reasons (WhatsApp conversations, intake forms, photos, and digital wallet). See the AI Connector article.