Skip to content

Installation

The PREQSTATION MCP server enables coding agents to interact with the task management API. Install for your platform below.

Prerequisites

  • Node.js 22+ installed
  • PREQSTATION API URL and bearer token (from /api-keys page in projects-manager)

Environment Variables

Set these before registering the MCP server:

Terminal window
export PREQSTATION_API_URL="https://your-preqstation-domain.vercel.app"
export PREQSTATION_TOKEN="preq_xxxxxxxxxxxxxxxxx"

Optional fallback engine (only needed if client auto-detection is unavailable):

Terminal window
export PREQSTATION_ENGINE="claude-code" # or codex, gemini-cli

Claude Code

Register the PREQSTATION MCP server with environment variables:

Terminal window
claude mcp add -s user \
--env='PREQSTATION_API_URL=https://<your-domain>' \
--env='PREQSTATION_TOKEN=preq_xxxxx' \
preqstation -- \
node /Users/kendrick/projects/preqstation-skill/scripts/preqstation-mcp-server.mjs

Codex CLI

Register the PREQSTATION MCP server:

Terminal window
codex mcp add preqstation \
--env='PREQSTATION_API_URL=https://<your-domain>' \
--env='PREQSTATION_TOKEN=preq_xxxxx' \
-- node /Users/kendrick/projects/preqstation-skill/scripts/preqstation-mcp-server.mjs

Gemini CLI

Gemini uses environment variables directly. Set them in your shell:

Terminal window
export PREQSTATION_API_URL="https://your-preqstation-domain.vercel.app"
export PREQSTATION_TOKEN="preq_xxxxxxxxxxxxxxxxx"

Then invoke Gemini with access to these variables. MCP server setup not required for Gemini CLI.

JSON Configuration Example

If you need to manually configure the MCP server in settings:

{
"mcpServers": {
"preqstation": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/preqstation-skill/scripts/preqstation-mcp-server.mjs"],
"env": {
"PREQSTATION_API_URL": "https://your-preqstation-domain.vercel.app",
"PREQSTATION_TOKEN": "preq_xxxxxxxxxxxxxxxxx"
}
}
}
}

Troubleshooting

MCP server fails to start:

  • Verify Node.js is installed: node --version
  • Check the script path is absolute
  • Confirm PREQSTATION_API_URL is valid (should start with https://)

Connection errors:

  • Verify token format (should start with preq_)
  • Test connectivity: curl -H "Authorization: Bearer $PREQSTATION_TOKEN" "$PREQSTATION_API_URL/api/health"

Token rejected:

  • Generate a new token from projects-manager /api-keys page
  • Ensure token has not expired