Quickstart

Hosted endpoint

Zero setup: the endpoint is always on at https://code.factorialhr.com/mcp.

Prerequisites: Factorial Code account and an API Credential with MCP endpoints.

OAuth vs No-OAuth

Endpoint	When to use
No-OAuth	Simplest: static token in the Authorization header. Best for Cursor, Claude Desktop, prototypes.
OAuth	OAuth 2.0 Client Credentials. For enterprise and central credential management.

Both come from the same API Credential. Revoke the credential to invalidate both.

Configure (No-OAuth)

Pass the token in the Authorization header:

{
  "mcpServers": {
    "fcode-mcp-server": {
      "url": "https://code.factorialhr.com/mcp",
      "headers": { "Authorization": "Bearer <your_token>" }
    }
  }
}

Replace <your_token> with the value from Settings → API Credentials.

Verification

1. Tools list appears in your MCP client
2. run_code executes (if enabled)
3. Process tools appear (tag with mcp-tool for instant exposure, or add custom tags to the tools query param — see Configuration)