pinelabs-online-mcp: Skill for Claude Code

Pine Labs MCP Local Setup

Guide users through setting up the Pine Labs MCP server locally and generating configuration for their preferred MCP client.

When to Use

• User wants to run Pine Labs MCP server locally (source or Docker)
• User needs config for VS Code, Claude Desktop, or Cursor
• User asks how to connect to the MCP server
• User needs to set up credentials or environment variables
• User wants to switch between UAT and production environments

Prerequisites Check

Before starting, verify:

1. Python 3.10+ is installed: python3 --version
2. Project is cloned and user is in the project root
3. Credentials available: User has Pine Labs client_id and client_secret

If Docker-based setup, only Docker is needed.

Setup Methods

Method 1: Source (Recommended for Development)

# 1. Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate        # macOS/Linux
# .venv\Scripts\activate         # Windows

# 2. Install dependencies
pip install -r requirements.txt

# 3. Create .env file (optional — avoids passing CLI args)
cat > .env << 'EOF'
PINELABS_CLIENT_ID=<your-client-id>
PINELABS_CLIENT_SECRET=<your-client-secret>
PINELABS_ENV=uat
LOG_LEVEL=INFO
EOF

# 4. Test the server starts
python -m cli.pinelabs_mcp_server.main stdio \
  --client-id <your-client-id> \
  --client-secret <your-client-secret> \
  --env uat

Method 2: Docker

# 1. Create .env file
cat > .env << 'EOF'
PINELABS_CLIENT_ID=<your-client-id>
PINELABS_CLIENT_SECRET=<your-client-secret>
PINELABS_ENV=uat
EOF

# 2. Build the image
docker build -t pinelabs-mcp-server .

# 3. Run via docker compose
cd examples && docker compose up

Client Configuration Generation

Ask the user which client they need, then generate the appropriate config.

VS Code (Copilot Chat)

File: .vscode/mcp.json (workspace) or user settings

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "pinelabs_client_id",
        "description": "Pine Labs Client ID"
      },
      {
        "type": "promptString",
        "id": "pinelabs_client_secret",
        "description": "Pine Labs Client Secret",
        "password": true
      }
    ],
    "servers": {
      "pinelabs": {
        "command": "python",
        "args": [
          "-m", "cli.pinelabs_mcp_server.main", "stdio",
          "--client-id", "${input:pinelabs_client_id}",
          "--client-secret", "${input:pinelabs_client_secret}"
        ]
      }
    }
  }
}