Manage Keepface from Claude Code (API tokens, MCP)

What this is

You can connect Keepface to Claude Code (Anthropic’s coding assistant) and manage your brand workspace by typing what you want. Behind the scenes Claude talks to a Keepface tool server over MCP, so instead of clicking through the panel you can say things like “show my pending affiliate conversions” or “build a list of Azerbaijani fashion micro-influencers” and it does it.

It covers almost the entire brand panel: discovery, lists, campaigns, outreach, affiliate, CRM, brand profiles, wallet and reporting reads, AI analysis, and creator chat. The only things it will never do are move money or change account security.

Step 1, create an API token

1. Open Settings, API Tokens in your brand workspace.
2. Click Create token, give it a name (for example “My Claude Code”).
3. Pick the scopes you want it to have. Each checkbox is one area of the panel:
   • discovery, lists, campaigns, outreach, affiliate, reporting for the core campaign workflow
   • wallet (read-only balance and transactions), crm (your roster and invites), brand (company profiles)
   • chat to read and send creator messages
   • analyze for paid on-demand AI Intelligence reports
4. Click create. The token is shown once, copy it now, you cannot see it again. The page also shows a ready-to-paste connection snippet.

Tip: grant only the scopes you need. You can always create a second token with more.

Step 2, connect Claude Code

After you create the token the page shows a connection snippet. It looks like this:

{
  "mcpServers": {
    "keepface": {
      "type": "http",
      "url": "https://mcp.keepface.com/mcp",
      "headers": { "Authorization": "Bearer kf_your_token_here" }
    }
  }
}

Add it to your Claude Code MCP configuration (the snippet from the page already has your token filled in). Claude Code connects, reads your token, figures out which workspace and scopes it has, and loads only the tools your scopes allow. You do not need to set a workspace header or anything else by hand, it is automatic.

Step 3, just talk to it

Once connected, ask in plain language. A few examples:

• “Search for beauty micro-influencers in Turkey and put the top 12 in a new list called Spring Beauty.”
• “Show me the report for my last campaign and tell me which creators underperformed.”
• “List my pending affiliate conversions for May.”
• “Who replied to the recruitment for campaign 41? Shortlist the ones with over 50k followers.”
• “What is my wallet balance and last 10 transactions?”
• “Draft and send a follow-up message to the creators in thread 88 and 91.” (it will preview first)

The safety model

This is the important part. The token is built so it cannot do damage on its own:

• Reads run instantly. Searching, listing, reading reports and balances never change anything.
• Every write previews first. Create a list, update a campaign, send a message, approve an affiliate, none of these run until you reply confirm. You always see exactly what will happen.
• Sends and deletes warn loudly. Sending a message or email, bulk-sending to many threads, deleting a list or campaign, each shows a clear warning in its preview before you confirm.
• Money is never on the table. Topping up, withdrawing, converting currency, paying influencers, and changing affiliate commission are not available to any token. They stay manual in the panel.
• One workspace only. The token can only act inside the brand workspace you made it in.

Managing tokens

Back in Settings, API Tokens you see every token you created for this workspace, when it was last used, and when it expires. Revoke any token with one click, the connection stops working immediately. Revoking does not affect your normal login.

Good to know

• Tokens expire after the number of days you set (default 90). Create a fresh one when it lapses.
• Each browser login is a separate session and is not shown here, this page lists only your Claude Code API tokens.
• If a request comes back “not authorized for this workspace”, the token is fine, it just means the workspace was not passed, which Claude Code handles for you automatically when connected through the snippet above.