Install

Install the plugin

The skillhook repository is a Claude Code, Codex and Cursor plugin. It registers two MCP servers, this machine and your organisation, and a skill that teaches the agent to triage and operate the fleet.

MCP and plugins

Step 1

Add the plugin

Pick your agent.

/plugin marketplace add MeterApp/skillhook
/plugin install skillhook@meterapp-skillhook

Type these in a Claude Code session, then run the login command in a terminal.

Step 2

Then log in once

In a terminal on the same machine.

It asks for an organisation API key, which an admin creates under Settings, API keys (it is shown once), and keeps it in ~/.skillhook/.env as SKILLHOOK_CLOUD_API_KEY, never printed. From then on the plugin's skillhook-cloud server and every skillhook cloud command use it; skillhook cloud logout removes it.

The command needs skillhook 0.7.0 or newer on the machine: npm install -g @meterapp/skillhook.

API keys and scopes

What you get

Two servers and a skill

The agent sees the machine in front of it and the organisation behind it, and knows what to do with both.

skillhook MCP server

This machine: its skills, jobs, webhook URLs, secrets and status, from the skillhook that runs on it.

skillhook-cloud MCP server

The organisation: the whole catalogue, with the tools the key's scope allows, once you have logged in.

skillhook-cloud skill

Teaches the agent how to triage and operate the organisation: start with describe_cloud, answer waiting agents, replay once a cause is fixed, ask before anything destructive.

Without the plugin

Just the hosted MCP server

The same tools from the cloud alone, with the key in SKILLHOOK_CLOUD_API_KEY. skillhook mcp --print-config prints the configuration for any MCP client; skillhook mcp --cloud serves the same tools locally.

claude mcp add --transport http skillhook-cloud https://skillhook.dev/api/mcp --header "Authorization: Bearer $SKILLHOOK_CLOUD_API_KEY"

Claude Code, one command.

{
  "mcpServers": {
    "skillhook-cloud": {
      "type": "http",
      "url": "https://skillhook.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SKILLHOOK_CLOUD_API_KEY}"
      }
    }
  }
}

Cursor, Claude Desktop and any client that expands environment variables.

Chat connectors

claude.ai and ChatGPT connectors sign in with the browser: add https://skillhook.dev/api/mcp as a connector and approve it for one of your organisations (see connectors). A ChatGPT custom GPT can also import https://skillhook.dev/openapi.json as Actions with Bearer authentication and gets every operation.

Using openapi.json