Claude Code

Claude Code is configured from the command line rather than a settings screen. The connect is a two-step command.

Tip

Already connected in Claude? Sign in to Claude Code with the same Claude account and the custom connector is available automatically — skip to asking. The steps below are for adding it directly. Re-authorize a carried-over connector at claude.ai/customize/connectors.

Before you start

You need	Notes
Your MCP server URL	ILC hosts ILC MCP and sends you the address. It looks like https://yourmcp.example.com/mcp — use the real one ILC sends you.
Your Fishbowl login	You sign in as yourself over OAuth, in the browser. Your Fishbowl permissions carry over.
Claude Code installed	—

Add the server

In your terminal, outside a Claude Code session, add ILC MCP as a remote HTTP server:

claude mcp add --transport http fishbowl https://yourmcp.example.com/mcp

The --transport http flag matters: without it, Claude Code treats the URL as a command to run instead of a remote server. Add -s user to make the server available across all your projects.

Authenticate

1. Start Claude Code with claude, run /mcp, and select fishbowl.
2. A browser opens. Sign in with your own Fishbowl user and grant the read-only scopes — sql:read and docs:read. Claude Code stores and refreshes the token for you.
3. Verify: run /mcp again, or claude mcp list from your shell. The status should read Connected.

Note

If sign-in completes but the server still shows Needs authentication, a stale process is usually holding the OAuth callback port — close other sessions and run /mcp again.

Ask your first question

In a session, ask in plain language:

How many customers are in Fishbowl?

Claude Code reads Fishbowl and answers from your live data. Any change still waits for your approval — see Using ILC MCP.

Using a different tool? See Claude or OpenCode.