MCP exposes the same methods as the External API: content factory, catalog, photo studio, files, AI jobs, knowledge base, and AI operator. The client uses the same host and the X-Api-Key header.
Who is calling
The key belongs to one user and one project. On connect the client receives the name, email, and project title. The brifly_session tool returns the same pair. The client cannot switch user or project: another pair needs another key.
Addresses
POST /mcp and GET /mcp. Production: https://api-external.brifly.online/mcp.
Tool name
The method path with slashes replaced by _. Example: ai-operator-tasks/list becomes ai-operator-tasks_list.
Argument
The data field matches the POST /v1/... body. The key scope is checked the same way as for HTTP. A foreign data.projectId returns PROJECT_MISMATCH.