Developer agents
Connect Codex to Brickway
Add Brickway as a Streamable HTTP server in Codex, then authenticate once through its MCP server controls.
Set up Codex
Brickway remote MCP server
https://api.brickway.app/mcp- In the ChatGPT desktop app or Codex IDE extension, open Settings → MCP servers → Add server. Choose Streamable HTTP, name it Brickway, and enter the URL below. Save and restart when prompted.
- Select Authenticate for Brickway. In Codex CLI, the equivalent action is `codex mcp login brickway` after adding the configuration below.
- Complete Brickway sign-in, select one or more collections, and choose one default.
- Use /mcp to confirm the server is connected, then ask Codex a collection question.
~/.codex/config.toml
[mcp_servers.brickway]
url = "https://api.brickway.app/mcp"What happens during authorization
The AI app opens Brickway in your browser. Brickway shows the requesting application and its exact return address, then asks you to sign in and choose which collections it may read. The AI app receives a Brickway-only MCP credential—never your Brickway sign-in token or Supabase session.
Never paste an API key, Supabase token, Brickway session, client secret, or custom Authorization header into the AI app. A compatible host discovers Brickway's public OAuth flow from the server URL.
What Codex can ask
- List only the collections you selected when connecting
- Summarize sets, minifigures, ownership, build states, brands, and locations
- Search your collection and inspect one item's safe catalog and build context
- Find duplicate copies and collectible-minifigure series gaps
- Compare LEGO theme progress and review bounded build history
- Search Brickway's global LEGO and alt-brick set catalog
Prompts to try
- “Do I own Rivendell, and how many copies do I have?”
- “Which sealed sets under 1,000 pieces could I build this weekend?”
- “Show my duplicate sets and loose minifigures.”
- “Which LEGO themes am I closest to completing?”
- “Summarize what I built this year and how long it took.”
Change access or disconnect
In Brickway, open Settings → AI connections. You can change this app's selected collections, disconnect it, or disconnect every AI app. Brickway revocation takes effect immediately even if Codex still displays the old connection.
The AI app processes tool inputs and results under its own terms, retention, and training policies. Brickway excludes email addresses, household members, prices paid, sellers, acquisition sources, private notes, OAuth details, and internal database fields. The connector cannot add, edit, or delete anything. Read Brickway's privacy policy for details.