Installation
Install the Tokencraft MCP server to use your design tokens with Claude Desktop and other MCP clients.
Prerequisites
- Node.js 18 or higher
- npm or npx
- A Tokencraft API token
- Claude Desktop (for Claude integration)
Installation Methods
Method 1: NPX (Recommended)
Use without installation:
npx @tokencraft/mcp-server
Method 2: Global Install
Install globally:
npm install -g @tokencraft/mcp-server
Method 3: Local Project
Add to your project:
npm install @tokencraft/mcp-server
Get Your API Token
- Visit app.tokencraft.dev/api-settings
- Click “New Token”
- Give it a name (e.g., “Claude Desktop”)
- Copy the token immediately
- Store it securely
The API token is shown only once. Store it in a secure location.
Verify Installation
Test the server:
# If using npx
npx @tokencraft/mcp-server --version
# If globally installed
tokencraft-mcp --version
Environment Variables
The server uses these environment variables:
| Variable | Required | Description |
|---|
TOKENCRAFT_API_TOKEN | Yes | Your API token |
TOKENCRAFT_API_URL | No | API base URL (default: https://app.tokencraft.dev/api/v1) |
Configuration File
Create a .env file for local testing:
TOKENCRAFT_API_TOKEN=dtk_your_token_here
TOKENCRAFT_API_URL=https://app.tokencraft.dev/api/v1
For Claude Desktop, you’ll configure these in the Claude config file instead.
Next Steps
Troubleshooting
Command Not Found
Error: tokencraft-mcp: command not found
Solution: Use npx instead or ensure global install path is in your PATH:
npm install -g @tokencraft/mcp-server
Node Version
Error: Requires Node.js 18 or higher
Solution: Update Node.js:
# Using nvm
nvm install 18
nvm use 18
Permission Errors
Error: EACCES permission denied
Solution: Use npx or fix npm permissions:
# Option 1: Use npx
npx @tokencraft/mcp-server
# Option 2: Fix permissions
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
Update
NPX
Always uses the latest version automatically.
Global Install
Update to the latest version:
npm update -g @tokencraft/mcp-server
Uninstall
npm uninstall -g @tokencraft/mcp-server
System Requirements
| Requirement | Minimum | Recommended |
|---|
| Node.js | 18.0.0 | Latest LTS |
| RAM | 512 MB | 1 GB |
| Disk Space | 50 MB | 100 MB |
| Network | Required | High-speed |
Security Notes
-
API Token Storage
- Store in environment variables
- Never commit to version control
- Rotate regularly
-
Network Access
- Requires internet connection
- Communicates with app.tokencraft.dev
- Uses HTTPS only
-
Rate Limits
- Same as REST API (100 req/min)
- Shared with other API usage
| Platform | Status |
|---|
| macOS | ✅ Supported |
| Windows | ✅ Supported |
| Linux | ✅ Supported |
| Claude Desktop | ✅ Full support |
| Cline | ✅ Compatible |
| Custom MCP clients | ✅ Standard MCP |
Need Help?
Once installed, configure Claude Desktop to use the Tokencraft MCP server.
