MCP Setup

Connect your AI assistant to Praximos in three steps: generate a token, configure your client, and verify the connection.

1. Generate an API Token

Navigate to Settings → MCP in your Praximos account (/settings/mcp)
Click Generate Token
Copy the token immediately — it won't be shown again
Tokens expire after 1 year by default

Security: Each token inherits the permissions of the user who created it. Use dedicated service accounts for shared AI integrations.

2. Configure Your AI Client

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "praximos": {
      "type": "http",
      "url": "https://your-domain.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Code (CLI)

Add to your project's .mcp.json:

{
  "mcpServers": {
    "praximos": {
      "type": "http",
      "url": "https://your-domain.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Local Development

For local development, the MCP endpoint is at http://localhost:4000/api/mcp. A development-only server with code reloading is also available at http://localhost:4000/ash_ai/mcp.

3. Verify the Connection

Once configured, your AI assistant should be able to discover Praximos tools. Try asking:

"List all my projects in Praximos"

If the connection is working, the assistant will invoke the projects_list_projects tool and return your project list.

Token Management

View active tokens: Settings → MCP shows all active tokens with expiry dates
Revoke a token: Click the revoke button next to any token to immediately invalidate it
Copy config: Use the copy button to get a ready-to-paste MCP config snippet

Protocol Versions

Praximos supports MCP protocol version 2024-11-05 for broad compatibility with existing AI tools. The latest protocol version (2025-03-26) may be used in future updates.