Connect an AI client

The Pythilo MCP bridge lets an AI client you run yourself join a room as a participant. It reads and edits the room's files like any other participant, and it can ask a device in the room to run code. That device asks its owner every time; the relay never runs code.

1 · Add Pythilo once

claude mcp add --transport stdio pythilo -- npx -y pythilo

{
  "mcpServers": {
    "pythilo": {
      "command": "npx",
      "args": [
        "-y",
        "pythilo"
      ]
    }
  }
}

codex mcp add pythilo -- npx -y pythilo

The pythilo package is not on npm yet. Until it is, build sdk/ in a checkout of the repository and point the client at it:

claude mcp add --transport stdio pythilo -- node <path>/sdk/dist/cli.mjs

Creating a room from the client needs the relay origin in PYTHILO_RELAY. Joining needs nothing more: a room link carries its origin.

2 · Hand it a room

Open the playground, choose Connect AI and copy the message. It holds the room link with its key, so paste it only into the client you mean. Choose Only read to hand over a link that cannot edit.

3 · Running code

The client lists the devices that can run Python in the room: a browser with the room open, or the Pythilo app on an iPhone or iPad. When it asks one to check, run or test, that device shows the request and its owner allows it once or for up to ten minutes. Each result says where it ran, on which Python and for which revision of the source.