Connect Claude Code

The Connect to Claude Code dialog in your APIANT account menu gives you one command that downloads the APIANT skills into a project directory and registers the APIANT MCP server for that directory. It needs no API key, Node or npm. You sign in through your browser the first time Claude Code connects.

Prerequisites

• An APIANT.ai account whose role has the MCP Tools permission. New accounts have it.
• Claude Code 2.1.157 or later, with the claude command on your PATH.
• A model with a context window of at least 1M tokens. The APIANT skills are only compatible with those models.
• On Mac or Linux, curl and unzip. On Windows, PowerShell, which is built in.
• A default browser on the same machine.

Install

1. Open the dialog

1. Sign in at app.apiant.ai.
2. Open the account menu (your initials and name, top right).
3. Select Connect to Claude Code. The same item is in the account menu on the Assistant page.

Connect to Claude Code is in the lower part of the account menu.

2. Copy the command

The dialog shows the command for the operating system your browser reports. Select Copy.

The dialog shows the command and a note: restart Claude Code, approve the server once, and update by re-running only the download half.

3. Run it in the project directory

Open a terminal, change to the directory you want to use Claude Code in, and run the command.

On Mac and Linux:

$ cd ~/projects/acme-integrations
$ curl -fsSL 'https://app.apiant.ai/appPlugin/plugin.zip' -o /tmp/a.zip && unzip -oq /tmp/a.zip -d . && rm /tmp/a.zip && { claude mcp remove apiant-ai -s project 2>/dev/null; claude mcp add --transport http -s project apiant-ai https://mcp.apiant.ai/mcp; }

On Windows, the command is one line, powershell -NoProfile -ExecutionPolicy Bypass -EncodedCommand <base64>, that runs the same steps as a PowerShell script. Paste it into Command Prompt or PowerShell.

claude mcp add merges into an existing .mcp.json and leaves other servers in it alone.

4. Start Claude Code and approve the server

1. Run claude in the same directory, or restart Claude Code if it was already open there.
2. Approve the apiant-ai server when Claude Code asks about the project's MCP servers.

5. Sign in

1. Run /mcp, select apiant-ai, and choose to authenticate. Claude Code also shows a notice at startup when a server needs sign-in.
2. In the browser page that opens, sign in with your APIANT email and password, or Continue with Google or Continue with GitHub. If your email belongs to more than one organization, pick one. If your account uses two-factor authentication, enter the 6-digit code.
3. On Authorize access, check the application, the permissions listed and the account under Signed in as, then select Allow.
4. Return to Claude Code. claude mcp list shows the server as connected.

The sign-in page offers email and password, Google or GitHub, followed by the Authorize access step.

6. Check the install

Run /apiant-setup in Claude Code, or ask:

Check that you're connected to APIANT.

Where the install lives

Everything the command writes is inside the project directory:

• ./.claude/skills/: the APIANT skills.
• ./.mcp.json: the apiant-ai server entry.

The sign-in token is stored by Claude Code, not in the project. Each directory is a separate install: run the command again in every project directory where you want APIANT.

Organization domains and tenant labels

The dialog builds the command for the account and address you opened it from, so always copy it from the dialog rather than from this page.

• If your organization has a tenant label, the command also registers the server with a --header "X-APIANT-Tenant: ..." option carrying that label. The header routes sign-in to your organization. If the label changes, copy the command from the dialog again, re-run it, and sign in again.
• If you open the dialog on your organization's own APIANT domain, the download and the server URL in the command use that domain. The server name stays apiant-ai.

Update the skills

Re-run only the download half of the command, then restart Claude Code. The commands below use the app.apiant.ai address; if the command from your dialog downloads from another address, use that one.

$ curl -fsSL 'https://app.apiant.ai/appPlugin/plugin.zip' -o /tmp/a.zip && unzip -oq /tmp/a.zip -d . && rm /tmp/a.zip

On Windows, in PowerShell:

PS> irm 'https://app.apiant.ai/appPlugin/plugin.zip' -OutFile $env:TEMP\a.zip; Expand-Archive -Force $env:TEMP\a.zip .; del $env:TEMP\a.zip

Do not re-run the whole command to update: its claude mcp remove step deletes the server registration together with Claude Code's stored sign-in, so you would sign in again.

Uninstall

1. In Claude Code, run /mcp, select apiant-ai, and choose Clear authentication to remove the stored sign-in.

2. Remove the server registration:

   bashCopy

   $ claude mcp remove apiant-ai -s project
   

3. Delete the APIANT skill folders from ./.claude/skills/. If that directory holds no other skills, delete it.

Troubleshooting

More symptoms are covered in Troubleshooting MCP.

Next steps

• Quickstart: build from Claude Code
• Authentication and permissions
• Working with Claude