Connect Claude Code

Add Acquisity to Claude Code and check your first campaign without changing it.

Use these steps for Claude Code, the terminal application. They are not the setup for Claude's web or Desktop chat connectors.

1. Create a key

In Acquisity, create a workspace API key with workspaces:read and campaigns:read. These permissions are enough for the first request below.

For campaign changes, use a workspace key and add campaigns:write. That permission also allows live launch and pause actions; it is not limited to drafts.

2. Add the connection

Run this in your terminal. Replace YOUR_ACQUISITY_API_KEY with the complete key you copied:

claude mcp add --transport http --scope user acquisity \
  https://api.acquisity.ai/mcp \
  --header "Authorization: Bearer YOUR_ACQUISITY_API_KEY"

--scope user makes the connection available across your Claude Code projects. The command saves the credential in your local Claude Code configuration. Use a private terminal, keep that configuration private, and do not share terminal history or screenshots containing the key.

For teams that keep configuration in a repository, use an environment-variable reference instead of committing a key. Claude Code supports ${ACQUISITY_API_KEY} in the headers of .mcp.json; set that variable in the environment that starts Claude Code. See Claude Code's configuration documentation.

3. Check the connection

claude mcp list

Look for acquisity with a connected status. Open Claude Code and use /mcp to inspect its tools and connection status. If it asks you to sign in through OAuth, check that the custom Authorization header was saved correctly.

4. Try a read-only request

Use Acquisity to list the workspaces I can access. Ask me which one to use, then list its campaigns. Do not change anything.

You should get workspace names and IDs, followed by campaign information after you choose a workspace. An empty campaign list can be a successful response if that workspace has no campaigns.

Try more prompts or fix a connection error.

Disconnect or replace the key

To remove this client connection:

claude mcp remove acquisity --scope user

To replace a key, remove the connection and add it again with the new key. Revoke the old key in Acquisity once the replacement works. Removing a connection does not revoke the key or stop a campaign already running.

Client configuration reference: Claude Code MCP documentation.