MCP Setup

Connect your AI agent (Claude, ChatGPT, etc.) to your Flowxtra recruitment account.

Connect via Claude.ai

The easiest way to connect is through Claude.ai's built-in MCP support:

Go to claude.ai and open Settings
Navigate to Integrations or Connected Apps
Click Add Integration and search for Flowxtra or enter the server URL:
```
https://app.flowxtra.com/mcp/flowxtra
```
You'll be redirected to the Flowxtra login page
Enter your email and password — this is the same account you use for the dashboard
After login, click Authorize to grant access
Claude now has access to your Flowxtra data

Your token is valid for 1 year. After that, simply reconnect.

Add Flowxtra to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "flowxtra": {
      "url": "https://app.flowxtra.com/mcp/flowxtra"
    }
  }
}

Restart Claude Desktop. You'll be prompted to authorize on first use.

Add the MCP server to your Claude Code settings:

{
  "mcpServers": {
    "flowxtra": {
      "url": "https://app.flowxtra.com/mcp/flowxtra"
    }
  }
}

Flowxtra uses OAuth 2.0 with PKCE for secure authentication:

Parameter	Value
Authorization Endpoint	`https://app.flowxtra.com/authorize`
Token Endpoint	`https://app.flowxtra.com/api/oauth/token`
MCP Endpoint	`https://app.flowxtra.com/mcp/flowxtra`
Discovery	`https://app.flowxtra.com/.well-known/oauth-authorization-server`
Access Token Lifetime	1 year
Refresh Token Lifetime	2 years

Scope	Description
`profile`	Read your name and email
`company`	Read company info and subdomain
`jobs:read`	View job listings
`jobs:write`	Create and update jobs
`applicants:read`	View applicant details
`applicants:write`	Update applicant status
`mcp`	Use MCP server tools

You can view and manage connected AI applications from your dashboard:

Make sure you've authorized Flowxtra (check Settings → API Rest → Connected Applications)
Your token may have expired — disconnect and reconnect