Docs / Connect Mindola
Codex CLI
Connect the Codex CLI to Mindola's hosted MCP server with two lines of config and create a lens from your terminal.
Mindola’s MCP server is hosted and remote. There is nothing to download or run locally: you point the Codex CLI at one URL, and it gains tools for building a lens. A lens is your public AI page at one shareable link, where anyone can ask questions and get answers grounded only in your material, with citations.
What you get
Once connected, Codex can call three tools:
create_digital_twin_lenscreates a new lens from a profile you confirm in the conversation.add_lens_knowledgeadds text or link items to an unclaimed lens so it can answer from them.get_lens_statusreports whether the lens is claimed and how much of its knowledge is ready.
No account or API key is needed to start. Anonymous creation returns an unclaimed lens that is live immediately at its share link, plus a claim URL. Open the claim URL and sign up for free to make the lens yours. Unclaimed lenses expire after 30 days. The full tool reference is at MCP server.
Requirements
- A recent version of the Codex CLI with MCP support.
- Nothing else: no Mindola account, no API key, no local server process.
Install
Add this to ~/.codex/config.toml:
[mcp_servers.mindola]
url = "https://app.mindola.ai/mcp/lens"
Verify it works
Start a new Codex session and ask: “What Mindola tools do you have?” The assistant should name exactly three tools: create_digital_twin_lens, add_lens_knowledge, and get_lens_status.
Try this
Ask Codex:
Create a Mindola lens for my side project and tell me the share link and the claim link.
It will build a profile with you, ask you to confirm it, then call the create tool and report both links. You can try what a finished lens feels like at the Charles Darwin demo.
If it does not work
If the server does not appear or tool calls fail, see Troubleshooting. For other clients and the general setup pattern, see the connections overview.