4
INSTALLATION
Jonathan Miller edited this page 2026-05-20 01:24:27 +00:00

Home

Installation

Prerequisites

  • Node.js 20.0.0 or later
  • npm (included with Node.js)
  • Access to the target API with valid credentials

Install

git clone https://git.mokoconsulting.tech/MokoConsulting/{{PROJECT_NAME}}.git
cd {{PROJECT_NAME}}
npm install
npm run build
npm run setup

The setup wizard will prompt for:

  1. Connection name -- a label for this instance (e.g. production, staging)
  2. API URL -- the base URL of the instance
  3. API key/token -- authentication credentials
  4. TLS verification -- whether to skip certificate verification (for self-signed certs)

Run npm run setup again to add more connections.

Register with Claude Code

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

{
  "mcpServers": {
    "{{PROJECT_NAME}}": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/{{PROJECT_NAME}}/dist/index.js"]
    }
  }
}

Restart Claude Code after adding the server.

Configuration File

The config is stored at ~/.{{PROJECT_NAME}}.json:

{
  "defaultConnection": "production",
  "connections": {
    "production": {
      "baseUrl": "https://api.example.com",
      "apiKey": "your-api-key"
    },
    "staging": {
      "baseUrl": "https://api-staging.example.com",
      "apiKey": "your-staging-key",
      "insecure": true
    }
  }
}

You can also set the {{ENV_PREFIX}}_CONFIG environment variable to use a config file at a custom path.

Verification

npm start

If configured correctly, the server will start listening on stdio.

Troubleshooting

"Failed to load config" error

Run npm run setup to create the config file.

Connection errors

  • Verify the API is reachable from your machine
  • For self-signed certs, set "insecure": true
  • Ensure the API key/token is valid

Revision History

Date Version Author Notes
2026-05-07 0.0.1 jmiller Initial installation guide

Repo: Template-MCP . MokoStandards

Revision Date Author Description
1.0 2026-05-09 Moko Consulting Initial version