Find the projects that use an MCP server
An MCP connection is a secret that gives agents a server's tools. A project's agents reach it only while the project links it. Before you replace the connection's token, point it at another server or delete it, check which projects link it: every one of them loses those tools when the connection stops working.
Who can do this: anyone who can open the secret. The list names only the projects you can see. Removing the link needs permission to edit the project, and you must own the connection or be an Org Owner or Admin.
List the projects
- In the sidebar, select Directory, then the Secrets tab.
- Find the connection. Type part of its name in Search, or pick its service in Type.
- Select its name. It opens beside the list on the Details tab.
- Select the MCP tab. Only an MCP connection has one.
- Read the list. Each row names a project and when it was linked, such as Linked 3d ago. With no link, the tab reads No project links it yet, and changing the connection affects no project.
Unlink it from a project
- On the MCP tab, select the project's name. Its Settings tab opens at the MCP section.
- Select Unlink on the connection's row.
- Check that the row is gone. No new session on that project reaches the server.
- Go back to the secret and repeat for each project still listed.
Removing the link leaves the secret attached to the project. To take it away too, see Attach a secret to a project.
Related
- Give a project's agents an MCP server — link a connection to a project.
- Replace or delete a secret — put in a new token, or remove the connection.
- Add a custom API or MCP server — define your organization's own MCP server.
- Secrets — what the MCP tab shows.