Connect with Codex

Requirements

• Codex CLI installed
• A Knowatoa account

Setup

1. Add this block to ~/.codex/config.toml:

[mcp_servers.knowatoa] url = "https://knowatoa.com/mcp"

To scope the server to a single project instead, put the same block in .codex/config.toml at the project root.

1. Authenticate:

codex mcp login knowatoa

Codex opens your browser so you can sign in to Knowatoa. After signing in, you’re connected.

Usage

Once connected, ask Codex about your AI search data:

• “How is my site doing in AI search?”
• “Show me my visibility across AI services”
• “What questions am I tracking?”
• “Add a question: What is the best CRM for small businesses?”

Removing the connection

Delete the [mcp_servers.knowatoa] block from ~/.codex/config.toml.

Troubleshooting

Browser login doesn’t complete Check that you’re signing in with the same email address associated with your Knowatoa account.

Authentication error Tokens refresh automatically in the background. If you ever do get an auth error, sign in again — that usually means the refresh token was revoked or your client cleared it.