11---
22title : Use MCP Toolkit from the CLI
33linkTitle : Use with CLI
4- description : Manage MCP profiles, servers, and catalogs using the Docker MCP CLI.
4+ description : Manage MCP profiles, servers, and catalogs using Docker MCP CLI.
55keywords : docker mcp, cli, profiles, servers, catalog, gateway
66weight : 35
77---
@@ -73,12 +73,12 @@ select a server, and check the **Server ID** field.
7373Servers are referenced by URI. The URI format depends on where the server
7474comes from:
7575
76- | Format | Source |
77- | --- | --- |
78- | ` catalog://<catalog-ref>/<server-id> ` | An OCI catalog |
79- | ` docker://<image>:<tag> ` | A Docker image |
80- | ` https://<url>/v0/servers/<uuid> ` | The MCP community registry |
81- | ` file://<path> ` | A local YAML or JSON file |
76+ | Format | Source |
77+ | ------------------------------------- | ----------------------- --- |
78+ | ` catalog://<catalog-ref>/<server-id> ` | An OCI catalog |
79+ | ` docker://<image>:<tag> ` | A Docker image |
80+ | ` https://<url>/v0/servers/<uuid> ` | The MCP community registry |
81+ | ` file://<path> ` | A local YAML or JSON file |
8282
8383The most common format is ` catalog:// ` , where ` <catalog-ref> ` matches the
8484** Catalog** field and ` <server-id> ` matches the ** Server ID** field shown in
@@ -222,39 +222,53 @@ $ echo ".vscode/mcp.json" >> .gitignore
222222
223223## Share profiles
224224
225+ Share profiles with your team using OCI registries or version control.
226+
227+ ### Share via OCI registry
228+
225229Profiles are shared as OCI artifacts via any OCI-compatible registry.
226230Credentials are not included for security reasons. Team members configure
227- OAuth separately after pulling.
231+ authentication credentials separately after pulling.
228232
229- ### Push a profile
233+ To push an existing profile called ` web-dev ` to an OCI registry:
230234
231235``` console
232- $ docker mcp profile push < profile-id > < registry-reference >
236+ $ docker mcp profile push web-dev registry.example.com/profiles/web-dev:v1
233237```
234238
235- For example :
239+ To pull the same profile :
236240
237241``` console
238- $ docker mcp profile push web-dev registry.example.com/profiles/web-dev:v1
242+ $ docker mcp profile pull registry.example.com/profiles/team-standard:latest
239243```
240244
241- ### Pull a profile
245+ ### Share via version control
246+
247+ For project-specific profiles, you can use the ` export ` and ` import ` commands
248+ and store the profiles in version control alongside your code. Team members can
249+ import the file to get the same configuration.
250+
251+ To export a profile to your project directory:
242252
243253``` console
244- $ docker mcp profile pull < registry-reference>
254+ $ mkdir -p .docker
255+ $ docker mcp profile export web-dev .docker/mcp-profile.json
245256```
246257
247- For example :
258+ Team members who clone the repository can import the profile :
248259
249260``` console
250- $ docker mcp profile pull registry.example.com/profiles/team-standard:latest
261+ $ docker mcp profile import .docker/mcp-profile.json
251262```
252263
264+ This creates a profile with the servers and configuration defined in the
265+ file. Any authentication credentials must be configured separately if needed.
266+
253267## Custom catalogs
254268
255- Custom catalogs let you curate a focused collection of servers for your team or
256- organization. For an overview of what custom catalogs are and when to use them,
257- see [ Custom catalogs] ( /manuals/ai/mcp-catalog-and-toolkit/catalog.md#custom-catalogs ) .
269+ Custom catalogs let you curate a focused collection of servers for your team
270+ or organization. For an overview of what custom catalogs are and when to use
271+ them, see [ Custom catalogs] ( /manuals/ai/mcp-catalog-and-toolkit/catalog.md#custom-catalogs ) .
258272
259273Catalogs are referenced by OCI reference, for example
260274` registry.example.com/mcp/my-catalog:latest ` . Servers within a catalog use
@@ -267,7 +281,8 @@ Use the Docker catalog as a base, then add or remove servers to fit your
267281organization's needs. Copy it first:
268282
269283``` console
270- $ docker mcp catalog tag mcp/docker-mcp-catalog registry.example.com/mcp/company-tools:latest
284+ $ docker mcp catalog tag mcp/docker-mcp-catalog \
285+ registry.example.com/mcp/company-tools:latest
271286```
272287
273288List the servers it contains:
@@ -279,7 +294,8 @@ $ docker mcp catalog server ls registry.example.com/mcp/company-tools:latest
279294Remove servers your organization doesn't approve:
280295
281296``` console
282- $ docker mcp catalog server remove registry.example.com/mcp/company-tools:latest \
297+ $ docker mcp catalog server remove \
298+ registry.example.com/mcp/company-tools:latest \
283299 --name <server-name>
284300```
285301
@@ -357,7 +373,8 @@ can find to your curated set.
357373To enable specific servers from your catalog without using a profile:
358374
359375``` console
360- $ docker mcp gateway run --catalog < oci-reference> --servers < name1> --servers < name2>
376+ $ docker mcp gateway run --catalog < oci-reference> \
377+ --servers <name1> --servers <name2>
361378```
362379
363380## Further reading
0 commit comments