KosmoKrator

data

KeystoneJS MCP Integration for Claude Code

Connect KeystoneJS to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit KeystoneJS feedback View package source

Connect KeystoneJS to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

KeystoneJS MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-keystone": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=keystone",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=keystone --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only KeystoneJS instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

KeystoneJS Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the KeystoneJS integration catalog.

MCP toolSource functionTypeDescription
integration__keystone__keystone_list_lists keystone.keystone_list_lists Read List all available lists (collections) in the KeystoneJS instance. Returns list keys, labels, and metadata.
integration__keystone__keystone_get_list keystone.keystone_get_list Read Get metadata and field schema for a specific KeystoneJS list. Returns field definitions, access control, and display configuration.
integration__keystone__keystone_list_items keystone.keystone_list_items Read List items in a KeystoneJS list with optional filtering, sorting, and pagination. Returns an array of items from the specified list.
integration__keystone__keystone_get_item keystone.keystone_get_item Read Retrieve a single item from a KeystoneJS list by its ID.
integration__keystone__keystone_create_item keystone.keystone_create_item Write Create a new item in a KeystoneJS list with the provided field values.
integration__keystone__keystone_list_users keystone.keystone_list_users Read List users in the KeystoneJS instance with optional filtering, sorting, and pagination.
integration__keystone__keystone_get_current_user keystone.keystone_get_current_user Read Get the profile of the currently authenticated KeystoneJS user. Useful for verifying the connection and understanding user permissions.

Related KeystoneJS Pages

KeystoneJS CLIUse direct JSON commands instead of MCP discovery. KeystoneJS MCPFull gateway reference and MCP tool names. KosmoKrator for Claude CodeClient-level gateway setup.