Connect Claude Code

Copy one command from Gadwal and paste it into Terminal.

Before you start

  1. Open Gadwal and choose Gadwal › Settings (⌘,), then the AI & MCP tab.
  2. Turn on MCP server. The Address line shows http://127.0.0.1:55183/mcp (you can change the port below it). The server only listens on this Mac.
  3. Check each connection's AI level in its connection settings: Off, Read-only, Ask before write or Full. Production connections start at Read-only. The AI only sees connections that aren't Off.

AI tools need an active trial or the lifetime unlock. On the free tier the server answers every tool call with a message saying so.

Add the server

  1. In Settings › AI & MCP › Connect AI, click Copy Command on the Claude Code row. Gadwal creates a token and copies a command like this one, with your real token in place of <token>:

    claude mcp add --transport http --scope user gadwal http://127.0.0.1:55183/mcp --header "Authorization: Bearer <token>"
  2. Paste it into Terminal and press Return. --scope user makes Gadwal available in every project.

  3. Start Claude Code and type /mcp. gadwal appears in the list as connected.

  4. Ask: “Using gadwal, describe the tables in my Sample Store connection.”

Notes

  • Claude Code saves the token in its own user config file in plain text, like every MCP header. Anyone who can read your home folder can read it. Make a new token in Gadwal if you think it leaked.

  • To remove it:

    claude mcp remove --scope user gadwal
  • Writes on an “Ask before write” connection appear in Gadwal’s review panel. Claude Code can wait up to 120 seconds for your answer, then check again.