# Connect an assistant to Mizu

Choose the guide for the assistant the user wants to connect. Read it before starting setup. Have the user complete Google sign-in and consent in the browser.

MCP server URL: https://mizu.getagentbay.com/mcp

- [Claude](/agents/claude.md)
- [ChatGPT](/agents/chatgpt.md)
- [Claude Code](/agents/claude-code.md)
- [Instinct](/agents/instinct.md)
- [Grok Bot](/agents/grokbot.md)
- [Muse](/agents/muse.md)

## Connect a new MCP client

1. Point your MCP client at the server URL above. Follow its OAuth discovery metadata. Register a public client with an approved callback URL, or use your existing registration.
2. Start authorization with PKCE (S256), a fresh state, the exact MCP resource URL and the `mizu:exchange` scope. Open the authorization link for the user. They sign in with their invited Google account and review the request.
3. At the registered callback, verify state and issuer. Redeem the one-use code with the original verifier, redirect URI and resource. Keep the credentials in the client’s credential store.
4. Initialize the MCP session and call `tools/list`. Mizu then shows Connected for this grant.

To ask about the user’s workspace, call `mizu_ask` with a message and a new `request_id`. Pass the returned `receipt_id` to `mizu_result` to read the reply. If submission is interrupted, retry the same message with the same request ID.
