Skip to main content

​
Prerequisites

  • Claude Code installed
  • Nogic CLI installed (uv tool install nogic or pip install nogic)
  • A project initialized with nogic init

​
Configuration

Run this from your project root: 
claude mcp add nogic -e NOGIC_API_KEY=YOUR_API_KEY -- nogic mcp
Replace YOUR_API_KEY with your Nogic API key (starts with sk_). This creates a .mcp.json file in your project root: 
{
  "mcpServers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

​
Global (All Projects)

To enable Nogic across all your projects: 
claude mcp add nogic -s user -e NOGIC_API_KEY=YOUR_API_KEY -- nogic mcp

​
Verify Connection

Start Claude Code in your project directory: 
claude
Ask Claude to verify:
“What Nogic tools do you have access to?”
Claude should list tools including before_writing, find_similar, find_symbol, etc.

​
Usage Examples

​
Before Writing New Code

“I need to write a function to parse JSON configuration files”
Claude will automatically call before_writing to check for similar existing code and detect your naming conventions.

​
Find Similar Code

“Find code similar to user authentication”

​
Explore Dependencies

“What functions does processPayment call?”

​
Check Impact

“What would be affected if I modify the validateInput function?”

​
Troubleshooting

“nogic: command not found” — Make sure Nogic is installed: uv tool install nogic or pip install nogic. Verify with nogic --version. “Invalid API key” — Make sure you replaced YOUR_API_KEY with your actual key. Verify with nogic projects list. “No project_id” — Run nogic init in your project. Check that .nogic/config.json exists. Tools not appearing — Restart Claude Code after editing the MCP config. Check for JSON syntax errors.

​
Next Steps

MCP Tools Reference

See all available MCP tools