MCP Server

1. Install dependencies

cd mcp-server && npm install

2. Generate an API token

php artisan app:generate-api-token

3. Configure your client

Add the server to your MCP client configuration. The server reads CONTACTS_API_TOKEN and CONTACTS_API_URL from the project's .env file automatically.

Connect from Claude.ai

1. Go to claude.ai → Settings → Connectors
2. Click Add Custom Connector
3. Enter the URL: https://ryangrissinger.com/mcp
4. Save — tools will appear in your next conversation

Claude Mobile syncs automatically once the connector is saved via the web interface.

Health check

curl https://ryangrissinger.com/mcp/health

Deployment

The remote server runs as a pm2 process on the same server as the Laravel app, proxied through Nginx.

# Start (first time)
pm2 start mcp-server/remote.js --name mcp-remote

# Check status
pm2 status mcp-remote

# View logs
pm2 logs mcp-remote

Env vars required: CONTACTS_API_TOKEN, CONTACTS_API_URL, and optionally MCP_REMOTE_PORT (default 3100).

Nginx proxy block

location /mcp {
    proxy_pass http://127.0.0.1:3100/mcp;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Connection '';
    proxy_buffering off;
    proxy_cache off;
    chunked_transfer_encoding on;
}