docs

Integrations

Troubleshooting

Common issues and how to fix them.

Browser doesn't open or connect

Copy the session URL from your agent's output and paste it into your browser manually. Make sure Google Chrome is installed. Check that your pop-up blocker isn't preventing the tab from opening.

"command not found: npx"

Node.js isn't installed. Download it from nodejs.org, then restart your terminal.

Agent doesn't know about Efecto

Restart your AI tool after adding the MCP config. Most tools need a restart to pick up new servers.

MCP server not starting

Run npx -y @efectoapp/mcp in your terminal to check for errors. The server should print a startup message.

"/plugin" command doesn't work (Claude Code)

Make sure you're typing the command inside Claude Code's chat — not in the regular terminal. You should see the Claude Code prompt first.

Claude doesn't know about Efecto (Claude Code)

Restart Claude Code after installing the plugin. Press Ctrl+C to close it, then type claude in Terminal to start it again.

Verify MCP config

Check your tool's MCP config file for an "efecto" entry. If it's missing, re-run the install for your tool:

Uninstall

Delete the efecto entry from your MCP config file and restart your tool. For Claude Code, you can also run:

npx @efectoapp/mcp uninstall