How do I use Craft MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Craft MCP Server list the features in my current workspace" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Craft MCP Server

A lightweight MCP (Model Context Protocol) server providing read access to craft.io.

Installation

npm install npm run build

Configuration

Set the following environment variables:

export CRAFT_API_KEY="your-api-key" export CRAFT_WORKSPACE_ID="your-workspace-id" export CRAFT_ACCOUNT_ID="your-account-id" export CRAFT_PORTAL_ID="your-portal-id" # optional

CRAFT_API_KEY: Your craft.io API key
CRAFT_WORKSPACE_ID: The workspace ID (used for /workspace/{id}/items endpoint)
CRAFT_ACCOUNT_ID: The account ID (used for /workspaces/{id} endpoint to list workspaces)

Usage

With Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json):

{ "mcpServers": { "craft": { "command": "node", "args": ["/path/to/craft_mcp/dist/index.js"], "env": { "CRAFT_API_KEY": "your-api-key", "CRAFT_WORKSPACE_ID": "your-workspace-id", "CRAFT_ACCOUNT_ID": "your-account-id" } } } }

Standalone

npm start

Available Tools

Tool	Description
`craft_ping`	Test connectivity to craft.io API
`craft_get_workspace`	Get workspace details
`craft_get_items`	Get items (products, features, etc.) from workspace
`craft_get_item`	Get a specific item by ID (e.g., `UPS-1234`)