Claude Code

• Claude Code installed and signed in.

1. 1

   Add SPREVA as a remote server. --scope user makes it available in every project:

   claude mcp add --transport http --scope user \
     spreva https://dev-app.spreva.ai/api/mcp

2. 2

   Start Claude Code, run /mcp, choose spreva and sign in. Your browser opens SPREVA.

3. 3

   Sign in, choose the workspace and click Allow. Back in Claude Code, spreva shows as connected.

• API key in a header

  Send a SPREVA API key as a Bearer token, for automation that runs without a person.

  export SPREVA_API_KEY=POST_API_KEY_...
  claude mcp add --transport http --scope user \
    spreva https://dev-app.spreva.ai/api/mcp \
    --header "Authorization: Bearer $SPREVA_API_KEY"

• The CLI and the Agent Skill

  Install the spreva command line and its Agent Skill, for agents that work in a terminal.

  export SPREVA_API_KEY=POST_API_KEY_...
  npx -y @spreva/cli skill install --target claude

• The CLI's stdio bridge

  Run spreva mcp as a local MCP server, for apps that only start servers on your machine.

  export SPREVA_API_KEY=POST_API_KEY_...
  claude mcp add --transport stdio --scope user \
    --env SPREVA_API_KEY=$SPREVA_API_KEY \
    spreva -- npx -y @spreva/cli mcp

Start a new conversation and ask:

Claude Code calls SPREVA's overview tool and answers with the workspace's time zone, what goes out next and anything that needs attention. The first time, Claude Code may ask you to allow the tool.

• With an API key in a header, a rejected key is reported as a failure: Claude Code does not fall back to signing in.
• Signed in with a Claude subscription, the connectors you added on claude.ai appear in Claude Code by themselves.

Something else? Troubleshooting covers sign-in loops, plans, limits and time zones.

• Connect Claude Code to tools via MCP(opens in a new tab)
• Agent Skills in Claude Code(opens in a new tab)