Connect Claude

Connect Claude

Add DataMagik to Claude as a custom connector, then ask Claude about your plant in plain language. You can also run DataMagik's own assistant on Claude.

There are two separate ways Claude and DataMagik work together:

• Claude uses DataMagik — you chat in Claude, and Claude reaches DataMagik through the DataMagik MCP server as a custom connector. Covered first on this page.
• DataMagik uses Claude — you chat in DataMagik's AI Assistant, and it runs on Claude through an Anthropic API key added to DataMagik's company keys. See Run the DataMagik assistant on Claude.

Setting	Value
Name	DataMagik
Remote MCP server URL	https://mcp.data-magik.com/mcp
OAuth Client ID / Secret	Leave empty

Personal plans (Free, Pro, Max)

1. In Claude, open Customize > Connectors (on some versions, Settings > Connectors).
2. Click +, then Add custom connector.
3. Enter the name and the server URL from the table. Leave Advanced settings empty.
4. Click Add, then Connect.
5. A DataMagik sign-in page opens. Sign in with your DataMagik account (password, Google or Microsoft) and approve access.

Free plan: Claude's Free plan allows one custom connector. Remove another one first if DataMagik will not add.

Team and Enterprise plans

Only a Claude Owner or Primary Owner can add a custom connector for the organization. Members then connect with their own DataMagik account, so each person keeps their own DataMagik permissions.

Owner — add DataMagik once for the organization

1. Open Organization settings > Connectors.
2. Click Add, hover Custom, then choose Web.
3. Enter the name and the server URL. Leave the OAuth fields empty.
4. Click Add. No sign-in happens at this step; that is expected.
5. Optional: open the connector to choose how its tools are approved for members, for example always ask for tools that change data.

Members — connect your own account

1. Open Customize > Connectors.
2. Find DataMagik (it has a Custom label) and click Connect.
3. Sign in to DataMagik and approve access.

Using DataMagik in a chat

1. In a chat, click + > Connectors and switch DataMagik on.
2. Start with: "Which DataMagik company am I working in?" If you belong to more than one, ask Claude to switch before you continue.
3. Then ask what you need, for example:
   • "Show yesterday's scrap by workcenter and reason."
   • "Which of my scheduled scripts failed this week, and why?"
   • "Build a daily 6 AM email of open customer returns."

Claude asks before running a tool unless you have chosen to always allow it. Keep approval on for tools that write to Plex, send email or print.

Claude Code and other developer tools

Claude Code adds the same server from the terminal:

claude mcp add --transport http datamagik https://mcp.data-magik.com/mcp

Then run /mcp in a Claude Code session and choose DataMagik to sign in.

Run the DataMagik assistant on Claude (company key)

DataMagik's AI Assistant, AI Agents and other AI features run on an AI provider key that your company supplies. To run them on Claude, add an Anthropic API key to the company keys.

A Claude subscription is not an API key. Claude Pro, Max, Team and Enterprise plans do not include API access. The key comes from the Claude Console and is billed there, by usage, separately from any Claude plan.

1. Create the Anthropic API key

1. Sign in to the Claude Console at console.anthropic.com with your organization's account. Set up billing if it is not set up yet.
2. Create a workspace for DataMagik (optional but recommended), so its spend and limits are separate.
3. Open API keys, click Create key, name it DataMagik, and choose the workspace.
4. Copy the key. It starts with sk-ant- and is shown only once.

2. Add it to DataMagik's company keys

1. In DataMagik, open AI Provider Keys and select the Company Keys tab. This tab needs administrator access.
2. On the Anthropic Claude card, pick a Model.
3. Paste the key into API key and click Save key.
4. Click Set active. The card is marked Active, and everyone without an active personal key now uses Claude.
5. Open the AI Assistant and ask a question to confirm it answers.

• Personal keys win. A user with their own active key under Your Keys uses that key instead of the company key.
• Models per assistant. Each assistant can keep Provider default or use a specific Claude model; see Managing AI Assistants.
• Watch spend in AI Token Usage, and set spend limits for the key's workspace in the Claude Console.
• Rotating the key: create a new key in the Console, type it over the old one on the card and click Replace key, then delete the old key in the Console.

See AI Provider Keys for more.

Troubleshooting

Problem	What to do
No Add custom connector option	On Team or Enterprise, ask an Owner to add DataMagik under Organization settings.
DataMagik is not in the list on Team or Enterprise	The Owner has not added it yet, or it is blocked for your group.
Connecting fails after you enter a client ID	Remove the connector and add it again with the OAuth fields empty.
Claude says a tool is not allowed	Your DataMagik account lacks the permission or license for it. Ask your DataMagik administrator.
Results come from the wrong company	Ask Claude which company is active and to switch.
The DataMagik assistant does not answer after adding the key	Check the Anthropic card is Active, the key's Console account has billing and credit, and the user has no other personal key active.