Skip to main content

Connector Gateway quickstart

In this quickstart, you register the public DeepWiki MCP server as a connector, grant it to a directory group, call one of its tools from Claude Code through the Connector Gateway, and see the call on the Tool Usage screen. You act as both the administrator and the user.

Prerequisites​

  • A Stacklok Enterprise deployment with the Connector Gateway enabled, as described in Configure the Connector Gateway.
  • Tool call recording turned on, as described in Record tool calls. Without it, the last step shows no data.
  • Outbound internet access from the Enterprise Manager and Connector Gateway pods, so they can reach https://mcp.deepwiki.com.
  • A console account with administrator access that also belongs to a directory group. See Users and groups.
  • Claude Code installed on your workstation.

Step 1: Register the connector​

  1. In the console's administration experience, open Connectors and select Add connector.

  2. On the wizard's Add connector step, fill in:

    • Name: DeepWiki
    • MCP server URL: https://mcp.deepwiki.com/mcp

    Keep the default Transport, Streamable HTTP, under Advanced options. Select Next.

  3. The console checks how DeepWiki authenticates. DeepWiki needs no credential, so on the Set up authorization step keep Authorization method set to None and select Next.

Step 2: Grant access to your group​

  1. On the Grant access step, choose a group you belong to under Groups.
  2. Select Create connector.

The Enterprise Manager checks the endpoint when it creates the connector. The wizard shows Connector created and "Access granted to 1 group." Select Done. DeepWiki shows Ready in the list, and its Access tab lists your group under Groups with access.

Step 3: Connect to the connector as a user​

  1. Open the account menu and choose User under Experience.
  2. Select Connectors under Gateways. DeepWiki appears under Available.
  3. Select Connect on DeepWiki.

The console confirms "Connected to DeepWiki", and the connector moves to Enabled with a Connected badge.

Step 4: Connect Claude Code​

  1. On the same Connectors page, select the Clients tab and copy the endpoint URL from Manual setup.

  2. Add the gateway to Claude Code, replacing <ENDPOINT_URL> with the URL you copied:

    claude mcp add --transport http connector-gateway <ENDPOINT_URL>

  3. Start Claude Code with claude, run /mcp, select connector-gateway, and choose to authenticate. Complete the sign-in with your corporate identity provider in the browser window that opens.

After you sign in, /mcp shows connector-gateway as connected. Its tools include DeepWiki's ask_question, prefixed with the connector's name and an ID, such as DeepWiki_<ID>_ask_question.

Step 5: Call a tool​

Ask Claude Code a question that uses DeepWiki:

Use DeepWiki to explain what the modelcontextprotocol/servers repository contains.

Approve the tool call when Claude Code asks. Claude Code calls ask_question through the Connector Gateway and answers from DeepWiki's response.

Step 6: See the call in Tool Usage​

  1. Switch back to the administration experience and open Tool Usage under Connectors.
  2. With Last 24h selected, find DeepWiki on the By connector tab. Its call count includes your call.
  3. Select By tool and find ask_question, the DeepWiki tool you called.

The gateway delivers recorded calls within a few seconds. If the tiles are still empty, reload the page.

What you accomplished​

You registered a connector, granted it to a directory group, connected to it as a user, called its tool from an MCP client through one gateway endpoint, and confirmed the call in the console. The same flow applies to any connector; most production connectors add backend authentication.

Next steps​

Troubleshooting​

The connector shows Setup check failed after you add it

The Enterprise Manager couldn't reach https://mcp.deepwiki.com. Check the Enterprise Manager pod's outbound network access, then open the connector, select Configure, and select Save. See A connector shows Setup check failed.

Claude Code lists no DeepWiki tools

In the user experience, open Connectors under Gateways. On the Tools tab, check that DeepWiki shows Connected. Also check that your account belongs to the group you granted in step 2. Then restart Claude Code so it lists the gateway's tools again.