Using Docker MCP Gateway

Docker MCP Gateway provides access to hundreds of MCP servers from a curated catalog, with security and scalability ensured by Docker. Sema4.ai Studio integrates with Docker MCP Gateway to provide a seamless experience for building agents. You'll easily control your MCP servers in Docker Desktop and use them with one click in Studio.

  • Discover and use hundreds of MCP servers from a curated catalog
  • Manage your MCP servers and their configurations securely through Docker Desktop
  • Use them in your agents through one click in Studio
Use MCP Servers in your agents
Use MCP Servers in your agents

Prerequisites

In order to use Docker MCP Gateway in Studio, you need to have:

How to use Docker MCP Gateway

Follow these simple steps to unleash the power of Docker MCP Gateway in Studio:

Open Docker Desktop

Open Docker Desktop and click on the MCP Toolkit tab.

Open Docker Desktop
Open Docker Desktop

Configure a MCP server

Click on the Catalog tab and search for the MCP server you want to use. As an example, we'll add Perplexity MCP server, which requires you to have a Perplexity API key.

Search for an MCP server
Search for an MCP server

Once you've found the MCP server you'd like to use, click on the + button to add it to your gateway. On the MCP server's configuration page, you'll need to provide the API key and any other required secrets or configurations for the MCP server. Some servers work without any configuration.

Configure the MCP server
Configure the MCP server

That's all it takes to configure an MCP server in to the gateway! Now over to Studio!

Link Docker MCP Gateway to Studio

Open Sema4.ai Studio and go to Actions. Then click on the MCP Servers tab. You'll see an element for linking with Docker MCP Toolkit. Click the icon to connect the Docker MCP Gateway to your Studio.

Link Docker MCP Gateway to Studio
Link Docker MCP Gateway to Studio

Once linked, you'll immediately see that Docker MCP Gateway is available as an MCP server in your Studio, and provides all combined tools that you have configured in Docker MCP Gateway.

Tools provided by Docker MCP Gateway
Tools provided by Docker MCP Gateway

This view has three options available:

  1. Refresh - refresh the list of tools provided by Docker MCP Gateway
  2. Unlink - unlink the Docker MCP Gateway from your Studio
  3. Open in Docker Desktop - open the Docker MCP Gateway in Docker Desktop

When editing adding or removing MCP servers in Docker MCP Gateway, you'll need to refresh the list of tools manually in Studio to see the changes.

Use the MCP server in your agents

Now you can use the Docker MCP Gateway with your agents just like any other MCP server. When creating or editing an agent and adding actions, you'll see Docker MCP Gateway as an option.

Use Docker MCP Gateway in your agents
Use Docker MCP Gateway in your agents

All tools that you have configured in the Docker MCP Gateway become available to your agents at once. Remember that if you change the setup in Docker MCP Gateway through Docker Desktop, your agents might not be able to use the tools they were initially configured to use.

Considerations

As of Sema4.ai Studio version 1.3.6, here are some considerations to keep in mind:

  • If you unlink Docker MCP Gateway from Studio, all tools provided by Docker MCP Gateway become unavailable to your agents.
  • Manual reload of tools is required in Studio after adding or removing MCP servers in Docker MCP Gateway.
  • Studio do not yet support MCP Servers with OAuth. Support is coming soon.
  • Sema4.ai Control Room does not yet support Docker MCP Gateway for deployed agents. Support is coming soon.
  • All tools that you've configured in Docker MCP Gateway are available to the agent - the ability to exclude/include individual actions will be supported soon.