> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getoneprofile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP servers

> Add a tool server to your workspace, sign in to it once, and let your agents use it.

An MCP server gives your agents a set of tools to call, like searching a wiki or reading issues. Add one to your workspace, connect it once, then choose which agents can use it.

<Frame caption="The MCP servers tab in Settings.">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/oneprofile/images/integrations/mcp-servers.png" alt="A catalog of MCP server tiles such as Notion, Linear and GitHub, each with a Connect button, above a table of already-added servers showing how each one connects and its status." />
</Frame>

## Add a server

<Steps>
  <Step title="Open MCP servers in Settings">
    Find it under Connections.
  </Step>

  <Step title="Connect a catalog server, or add your own">
    Click **Connect** on a listed tile to sign in, or open **New server** to add one by URL and an API key instead.
  </Step>

  <Step title="Choose which agents can use it">
    Open an agent's editor and click **Add existing server**, or **Add to agent** straight from the catalog tile.
  </Step>
</Steps>

## Two ways to connect

A catalog server signs in with **Sign-in**, the same way you would sign into that tool directly. A custom server connects with an **API key** instead, pasted in along with the headers it needs.

## Remove a server

**Remove from this agent** stops one agent from using a server without touching anyone else's access. **Delete** removes the server from the whole workspace and every agent that used it.

## Good to know

<AccordionGroup>
  <Accordion title="What can I see about a server before adding it?">
    Its name and a short line describing what it can do. Once connected, **Test connection** lists the tools it actually exposes.
  </Accordion>

  <Accordion title="What does it mean when a server needs reconnecting?">
    The sign-in behind that server expired or was revoked. Reconnect it from the servers table or an agent's list.
  </Accordion>

  <Accordion title="Does adding a server to the workspace give every agent access?">
    No. Adding it to the workspace makes it available, but each agent only gets to use the servers you add to that specific agent.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="The integration directory" icon="boxes" href="/integrations/the-integration-directory">
    Browse the tools Oneprofile connects to directly.
  </Card>

  <Card title="Build an agent" icon="bot" href="/agents/build-an-agent">
    Give an agent the servers it needs while you build it.
  </Card>
</CardGroup>
