Grok

Grok CLI

Add the server for your user:


grok mcp add -s user korala https://api.korala.ai/mcp

Start grok in a terminal. Grok opens a browser the first time it uses Korala. To sign in straight away, run /mcps, select korala and press i.
Approve the connection on Korala’s consent page. See Permissions and safety.

The sign-in needs an interactive session. Run it once; Grok stores the token in ~/.grok/mcp_credentials.json and refreshes it.

The first command writes this block to ~/.grok/config.toml. You can add it by hand:


[mcp_servers.korala]
url = "https://api.korala.ai/mcp"
enabled = true

Use -s project to write .grok/config.toml in the current project instead. grok mcp doctor korala checks the connection.

The Korala plugin

Grok CLI installs Claude Code plugins. The Korala plugin adds the same server and a skill that tells Grok how to draft, prepare, send and track documents:


grok plugin marketplace add korala-ai/claude-plugins
grok plugin install korala --trust

Grok keeps a plugin’s MCP server off until you trust the plugin, so keep --trust. Then sign in with /mcps as above. If you already ran grok mcp add korala, that entry wins over the plugin’s server of the same name.

API key alternative

For machines where nobody can open a browser:


grok mcp add korala-local \
  -e KORALA_API_KEY_ID=your-key-id \
  -e 'KORALA_API_SECRET=${KORALA_API_SECRET}' \
  -- npx -y @korala/mcp

Grok expands ${KORALA_API_SECRET} from your environment when it starts the server, so the secret stays out of the config file. See API key (CI and headless).

Grok on grok.com

Grok on the web can use custom connectors. xAI documents them for Grok Business and Enterprise; in a team, an admin may need to add the connector.

Go to grok.com/connectors .
Choose New Connector, then Custom.
Enter https://api.korala.ai/mcp and complete the sign-in. Approve the connection on Korala’s consent page.

xAI’s documentation does not say which sign-in methods connectors support, and we have not tried this form. If Grok cannot complete the Korala sign-in, use the Grok CLI.