utekari-auth

Utekari MCP Authentication Setup

The utekari MCP server requires a personal bearer token via the UTEKARI_MCP_TOKEN environment variable. The .mcp.json passes this as Authorization: Bearer ${UTEKARI_MCP_TOKEN}.

Steps

1. Instruct the user to generate a token

Tell the user verbatim:

Open https://hra.utekari.cz/management/settings in your browser, generate a personal API token, copy it, and paste it into this chat.

Stop and wait for the token. Do not guess, fabricate, or proceed without it.

2. Offer two paths

Ask which they prefer:

A. Claude updates settings automatically (default). Claude writes the token into ~/.claude/settings.json under the env key.

B. User configures manually. Provide them with this one-liner to run in their shell:

claude config set -g env.UTEKARI_MCP_TOKEN "<paste-token-here>"

Or edit ~/.claude/settings.json directly:

{
  "env": {
    "UTEKARI_MCP_TOKEN": "<paste-token-here>"
  }
}

3. If user picks path A — Claude writes it

Read ~/.claude/settings.json. Add or update the env.UTEKARI_MCP_TOKEN field with the token the user pasted. Preserve all other settings. Use the Edit or Write tool — never shell-redirect to avoid clobbering.

If the file does not exist, create it with minimal content:

{
  "env": {
    "UTEKARI_MCP_TOKEN": "<token>"
  }
}

4. Optional: custom URL

If user runs custom Utekari instance, also set UTEKARI_MCP_URL. Default https://hra.utekari.cz/mcp applies otherwise.

5. Ask for restart

Env vars load at Claude Code startup. MCP server re-reads headers on reconnect. Tell user:

Token saved. Restart Claude Code (/exit then relaunch) for the utekari MCP server to pick up the new token.

6. After restart

User can verify by calling any utekari MCP tool. If auth still fails, re-run this skill — token may be wrong, expired, or revoked.

Security

• Token = user secret. Never log, echo to chat after save, commit to git, or share with subagents.
• ~/.claude/settings.json is local to user machine — safe destination.
• Never write token into repo files (.mcp.json, .env tracked by git, etc.).