Skip to main content

Connect Claude Tag to MintMCP

Claude Tag lets your team call Claude from a Slack channel with @Claude. Connect it to MintMCP so Claude Tag can use your MCP tools, authenticated with an API key from an agent identity MCP — a shared service account the whole channel uses.

info

Claude Tag is currently in beta. We'll update this guide as the setup changes.

Prerequisites​

  • MintMCP admin access
  • Owner or admin access to your Claude organization — access bundles live in Claude's organization settings
  • Claude Tag (Beta) enabled for your Slack workspace

Create an agent identity MCP in MintMCP​

An agent identity MCP acts as a service account: its API key is shared across the team rather than tied to an individual user.

  1. In MintMCP, go to MCP store → Manage store
  2. Click + Add an MCP to your registry
  3. Select Create an agent identity MCP
  4. Give it a name (for example, "Mint Read") and click Create

Restrict tools​

By default the agent identity MCP exposes every available tool. Narrow the set to what the channel needs, since fewer tools improve Claude's tool selection and reduce risk.

  1. Open the new MCP and go to the Tools tab
  2. Enable only the tools the channel should use, and disable the rest

Create an API key and copy the server URL​

  1. Open the Agent Setup tab of the agent identity MCP
  2. Under Agent API authorization, click + Create key
  3. Name the key (for example, "claude tag key") and create it
  4. Copy the secret — it is shown only once
  5. Copy the MCP Server URL below the key, for example https://app.mintmcp.com/o/mintmcp/s/mint-readonly/mcp — you'll need both the secret and this URL in Claude
MintMCP Agent Setup tab showing the agent key and the MCP Server URL

API keys expire after about 30 days. Rotate the key and update the Claude connection before it expires to avoid interruptions.

Connect MintMCP in a Claude access bundle​

An access bundle holds the connections Claude Tag can use in a channel. Add MintMCP to the bundle as a connection.

  1. In Claude organization settings, go to Claude Tag → Access bundles
  2. Open the bundle you want to use, or create one (for example, "mint-tag-test")
  3. On the Credentials tab, click + Connect another app
Access bundle Credentials tab with the Connect another app button
  1. Set Name to something recognizable, for example "mint-read-only"
  2. Set Credential type to Bearer
  3. Set Allowed websites to the host from your MCP Server URL, for example app.mintmcp.com
  4. Under Custom headers, add a header named Authorization with prefix Bearer and paste the API key as the value
  5. Click Connect
Connect an app dialog with Bearer credential type, allowed website, and Authorization header

Add the path prefix​

The path prefix tells Claude which MintMCP server to reach. It appears only after the connection exists, so set it by editing the connection you just created.

  1. On the connected app, click the three-dot menu (⋯) and select Edit
Connected app menu showing Edit, Rotate secret, and Delete
  1. Under Path prefixes, add the path from your MCP Server URL — everything starting at /o/. For https://app.mintmcp.com/o/mintmcp/s/mint-readonly/mcp, the prefix is /o/mintmcp/s/mint-readonly/mcp.
  2. Click Save
Edit connection dialog showing the Path prefixes field

Attach the bundle to a Slack channel​

Claude Tag applies access per channel, so attach the bundle to the channel where your team will use it.

  1. In Claude organization settings, go to Claude Tag → Slack and select the channel
  2. Under Access bundles, click + and choose your bundle (for example, "mint-tag-test")
Claude Tag channel access page with the access bundle dropdown open

Use it in Slack​

In the channel, mention @Claude and ask it to use a MintMCP tool. Claude authenticates with the API key and calls the tools enabled on the agent identity MCP.

Slack channel where a user asks Claude to list MintMCP tools