MCP server overview

What it is#

@lebureau/mcp is a Model Context Protocol server published on npm. It lets MCP-aware clients -- Claude Desktop, Claude Code, and any other MCP-compatible assistant -- call Le Bureau's REST API as native tools. Once installed, your assistant can read, control, and orchestrate your cloud desktops directly from a chat conversation, without leaving the client.

The package is open at npmjs.com/package/@lebureau/mcp. Install with npx -y @lebureau/mcp@latest -- the binary is lb-mcp.

What it lets the assistant do#

After connecting, the assistant gains a set of tools to operate Le Bureau on your behalf. It can list your desktops, start or stop them, take screenshots, send mouse and keyboard input, run Python code on the desktop's agent runtime, chat with the AI agent that lives on the desktop, manage scheduled jobs, and search your workspace knowledge base. Eighteen tools ship in version 0.1.0; see MCP tools for the full list.

How it connects#

The data path is short. Your MCP client launches lb-mcp as a local subprocess and speaks MCP over stdio. lb-mcp then calls Le Bureau's REST API at https://lebureau.talentai.fr/v1/ over HTTPS, authenticating with your API key. No request and no response is routed through any third party. Stdio is the only transport in 0.1.0; remote HTTP is deferred to a future release.

Capability model#

Every API key carries an explicit list of capabilities -- a server-side allowlist of which operations the key may perform. When lb-mcp starts, it calls /v1/me to read the capabilities attached to your key, then registers only the tools your key is allowed to call. Tools you cannot use are never exposed to the assistant, which keeps the prompt surface small and prevents accidental invocation. See API capabilities for the full scope catalogue.

Not in v0.1.0#

Destructive operations -- creating or destroying desktops, deleting scheduled jobs -- are not available through the MCP server in this release. Admin-only tools are also reserved. Both groups are planned for a future release; no date is committed.