Skip to main content

​
MCP Setup

​
Claude Desktop

Add the Faces MCP server to your Claude Desktop configuration:
  1. Open Claude Desktop settings
  2. Navigate to the MCP Servers section
  3. Add a new server with this configuration:
{
  "mcpServers": {
    "faces": {
      "url": "https://mcp.faces.app/sse"
    }
  }
}
  1. Save and restart Claude Desktop
  2. When prompted, sign in to your Faces account through the browser
The MCP server uses OAuth. You’ll authenticate through your browser the first time you connect. No API key needed.

​
Claude Code

Add the Faces MCP server to Claude Code: 
claude mcp add faces --transport sse https://mcp.faces.app/sse

​
Other MCP clients

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

​
Verify the connection

After connecting, ask Claude:
List my Faces projects
Claude 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.