# Connect Codex to Beamline

Beamline's MCP server: https://mcp.beamline.io/mcp (remote, Streamable HTTP, OAuth sign-in).

1. **Add the server.** In any terminal.

   ```bash
   codex mcp add beamline --url https://mcp.beamline.io/mcp
   ```
2. **Sign in.** Opens your browser: Google, GitHub or an e-mail code.

   ```bash
   codex mcp login beamline
   ```
3. **Connect each app.** Once per app folder. Every later session there uses Beamline without being asked.

   ```bash
   npx --yes -p https://mcp.beamline.io/cli.tgz beamline-connect --hosted https://mcp.beamline.io/mcp
   ```

Or send Codex this message:

```text
Set up Beamline for this app, so you build its UI from Beamline's React components.
1. Add the MCP server: run `codex mcp add beamline --url https://mcp.beamline.io/mcp`.
2. Sign in: run `codex mcp login beamline` and ask me to finish in the browser it opens (Google, GitHub or an e-mail code).
3. Connect this app: in its folder, run `npx --yes -p https://mcp.beamline.io/cli.tgz beamline-connect --hosted https://mcp.beamline.io/mcp`.
4. Tell me to start a new Codex session in this app: it loads the tools. From then on, call beamline_capabilities before any UI work.
```

Then your agent reads what each of Beamline's 190 React components and screens is for (beamline_capabilities), installs only the parts a screen needs into your repo (beamline_install), as a ready-built package or as plain React source, and checks the result. Sign in once with Google, GitHub or an e-mail code: the free sample opens at once, and what your team bought comes with you.

Other agents: [Claude Code](https://beamline.io/connect/claude-code.md) · [Cursor](https://beamline.io/connect/cursor.md) · [Claude](https://beamline.io/connect/claude.md) · [VS Code](https://beamline.io/connect/vscode.md) · [Gemini CLI](https://beamline.io/connect/gemini.md) · [Windsurf](https://beamline.io/connect/windsurf.md) · [ChatGPT](https://beamline.io/connect/chatgpt.md) · [Any MCP client](https://beamline.io/connect/any.md)

- [What Beamline is](https://beamline.io/) · [The component library](https://beamline.io/components/) · [Docs](https://beamline.io/docs) · [Get Beamline](https://beamline.io/checkout?pack=complete)