Skip to main content

​
Claude.ai

Open Faces in the Claude Connectors directory, add the connector, and authenticate with your Faces account through the browser.

​
ChatGPT

Open Faces in the ChatGPT plugin directory, select Faces, and follow the prompts to connect your account.
Faces uses OAuth, so no API key is needed. The same Faces MCP server also works in other MCP-compatible clients, including Claude Code and Codex.

​
Claude Code

Add the Faces MCP server to Claude Code:

​
Other MCP clients

Any MCP-compatible client can connect to the Faces server. Use:
  • HTTP endpoint: https://mcp.faces.app/mcp
  • Auth: OAuth 2.0 with dynamic client registration (authorization server metadata at https://mcp.faces.app/.well-known/oauth-authorization-server)

​
Verify the connection

After connecting, ask your assistant:
List my Faces projects
The assistant should use the list_projects tool and show your projects. If you see an authentication error, try disconnecting and reconnecting to re-trigger the OAuth flow.

​
Troubleshooting

​
”No authenticated user” error

The OAuth token may have expired. Disconnect the MCP server in your client and reconnect to trigger a fresh authentication.

​
Tools not appearing

Make sure you’re using a client that supports MCP tool discovery. Restart the client after adding the server configuration.

​
Rate limits

The MCP server shares the same 50 requests per minute limit as the REST API. If Claude is making many rapid requests, it may hit this limit.