Skip to main content

​
MCP setup

Navi MCP is designed for one-command setup through the navi CLI.

​
Prerequisites

Before you install MCP, make sure:
  • the navi CLI is installed
  • you know your Navi base URL
  • you have already authenticated with the CLI
Run these commands in order: 
navi config set-base-url https://dev.meridian7.io
navi auth login --cookie "<your-session-cookie>"
navi mcp install
After installation, restart Claude Desktop.

​
What navi mcp install does

The installer writes a navi MCP server entry into your local Claude Desktop config file and points it at the local Navi MCP server. The installed config includes:
  • your Navi base URL
  • your current local auth settings
  • the command Claude Desktop should use to launch Navi MCP

​
Inspect before writing

If you want to preview the exact MCP configuration first: 
navi mcp print-config

​
Claude Desktop config path

On macOS, the config file is: 
~/Library/Application Support/Claude/claude_desktop_config.json
On Linux, the default is: 
~/.config/Claude/claude_desktop_config.json

​
Verify the installation

After restarting Claude Desktop:
  1. Open a new conversation.
  2. Confirm that Navi tools are available.
  3. Try a simple prompt such as:
List the available Navi agents.

​
Troubleshooting

​
Claude Desktop does not show Navi tools

  • run navi mcp print-config and inspect the generated config
  • confirm the file was written to the correct Claude config path
  • restart Claude Desktop fully

​
Authentication fails

  • run navi auth whoami in the terminal first
  • refresh the session cookie if needed
  • reinstall MCP after updating your login

​
You want to review the config without changing files

navi mcp print-config