Add an MCP server

Many apps have their own MCP server: an address that gives AI agents the app's tools. Add one to an agent, and the agent works with that app like with any other connection. It is the way to connect an app that is not in the Library.

How do I add an MCP server?

1. Click Connections in the left rail, then Add MCP server at the top right. In the Library, the same window opens from Does the app have its own MCP server? Add it below the list.
2. Paste the MCP server URL. You'll find it in the app's documentation. It starts with https://.
3. Check the Name. The agent sees the server's tools under this name.
4. Pick the Agent that gets the server.
5. Check Sign-in. AgentOS asks the server how it signs in and picks the method for you.
6. Click Add. For an OAuth server, click Add and sign in, and sign in to the app in the window that opens.

The agent gets the server's tools within a minute.

How does the server sign in?

Sign-in	When	What you fill in
OAuth	The server signs in with your account in the app.	Nothing. You sign in to the app in a new window, and the token stays on the agent's machine.
API key	The server asks for an API key.	The API key. It goes as Authorization: Bearer. For a server that wants another header, such as X-API-Key, click Send the key in another header.
No sign-in	The server needs no sign-in.	Nothing.

Some apps ask you to register an OAuth app first. Click Use your own OAuth app and fill in its Client ID and Client secret. The window shows the Redirect URI for your OAuth app to enter in the app.

AgentOS adds a server with an API key or No sign-in once the server answers. The server must be reachable from the internet over HTTPS.

How do I check or remove a server?

The server is listed in Your connections. Open its row:

What you see	What to do
<agent> has the tools of <name>.	The server works. Test shows how many tools it gives. An OAuth server also offers Sign in again.
<name> is waiting for its sign-in.	Click OAuth and sign in to the app in the window that opens. Until then the agent doesn't have its tools.

To take the server away, click Remove and confirm. The agent loses the server's tools, and the server's API key is deleted from the agent's machine. To end an OAuth sign-in for good, also remove AgentOS's access in the app.

Add MCP server or Connect AI?

They work in opposite directions.

	What it does	Where
Add MCP server	Gives your agents the tools of another app.	Connections > Add MCP server
Connect AI (MCP)	Brings AgentOS into your own AI tool, such as Claude, ChatGPT or Cursor.	Connect on the Connect AgentOS via MCP or API card in Connections. See Connect AI (MCP).

Next: Connections and security, to set what each agent may do with your data.