Claude Code CLI

The Claude Code CLI talks to Figgshield over the same MCP endpoint as the Claude connector. You add the server once, sign in, then ask Claude Code to generate — it calls Figgshield’s tools for you.

Add the server

claude mcp add --transport http figgshield https://api.figgshield.ai/mcp

This registers a server named figgshield on the HTTP transport. Confirm it is listed:

claude mcp list

Sign in (browser OAuth)

claude mcp login figgshield

claude mcp login runs an authorization-code + PKCE flow over a loopback redirect: it opens your browser, you sign in with Google, Apple or GitHub and approve the figgshield:read and figgshield:write scopes, and the CLI stores the token. Tokens refresh automatically, so this is a one-time step. To sign out:

claude mcp logout figgshield

API-key alternative

Instead of the browser flow you can authenticate with a personal API key. Create one in the app under Account → API keys (it looks like figg_ followed by 40 hex characters, shown once) and pass it as an Authorization header when adding the server:

claude mcp add --transport http figgshield https://api.figgshield.ai/mcp \
  --header "Authorization: Bearer figg_your_api_key_here"

With the header set there is no claude mcp login step — every request carries the key. Keys can be named, rotated and revoked independently in the account screen; see Authentication.

Generate

Once the server is added and authenticated, prompt Claude Code as usual:

Generate a 5-second video of a quiet harbour at dawn.
Create a 4K image of a paper boat on a still pond.
List my recent Figgshield generations.

Claude Code calls generate_video (Kling) or generate_image (Nano Banana 2), polls get_generation for longer jobs, and gives you the output_url to download. The MCP tools reference lists every tool and its parameters.

Skills

A Claude skill that uses Figgshield inherits the host’s authentication — if Claude Code is signed in to the figgshield server (via OAuth or an API-key header), the skill can call the tools without any extra setup.

Troubleshooting

Symptom	Fix
401 / repeated sign-in prompts	Run claude mcp login figgshield again, or check the API-key header is a current, unrevoked key.
subscription_required tool error	The account has no active plan — subscribe in the app, then retry.
insufficient_credits tool error	Top up or enable auto top-up; the next monthly grant also refills the balance.
Server not found	Re-check the transport and URL: claude mcp add --transport http figgshield https://api.figgshield.ai/mcp.