> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Management MCP (Beta)

> Manage a Nango environment from an MCP client.

<Note>
  The Management MCP server is in Beta. We will continue to add functionality, with the goal of supporting the full public API. This means we may introduce breaking changes along the way. We would love to hear your feedback and requests!
</Note>

The Management MCP server lets MCP-compatible clients manage Nango through tools. It is an agent-friendly alternative to the [public API](/reference/backend/http-api/authentication).

## Connect

The server uses the Streamable HTTP transport at:

```text theme={null}
https://mcp.nango.dev/mcp
```

Configure your MCP client to send a Nango API key as a Bearer token:

| Header          | Value                    |
| --------------- | ------------------------ |
| `Authorization` | `Bearer <NANGO-API-KEY>` |

Manage API keys in **Environment Settings > API Keys** in the Nango UI. The API key determines which Nango environment the client can access. To limit what the MCP client can do, you can [scope down the API key](/reference/backend/http-api/api-keys#scopes) to only the tools it needs. The required scope for each tool is listed below.

<Note>
  The `environment:mcp` scope is not required for Management MCP tools. That scope is used by the separate [action-function MCP server](/guides/functions/tool-calling#mcp-server), which exposes enabled action functions as tools.
</Note>

Keep the API key server-side and only configure it in MCP clients you trust. Do not expose it in client-side code, logs, or URLs.

## Tools

### Connect sessions

Use the Connect Session tools to start an authorization flow for an end user.

| Tool                     | Description                                | Required API key scope               |
| ------------------------ | ------------------------------------------ | ------------------------------------ |
| `connect_session_create` | Create a new Connect session and its link. | `environment:connect_sessions:write` |

### Integrations

Use the Integrations tools to inspect and manage integrations in the authenticated Nango environment.

| Tool                  | Description                                                                                     | Required API key scope                                                         |
| --------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `integrations_list`   | List integrations configured in the environment.                                                | `environment:integrations:list`                                                |
| `integrations_get`    | Get a configured integration by ID.                                                             | `environment:integrations:read` or `environment:integrations:read_credentials` |
| `integrations_create` | Create an integration with caller-supplied or Nango-provided developer application credentials. | `environment:integrations:create`                                              |
| `integrations_update` | Update a configured integration by ID.                                                          | `environment:integrations:update`                                              |
| `integrations_delete` | Delete a configured integration by ID.                                                          | `environment:integrations:delete`                                              |

### Connections

Use the Connections tools to inspect connections in the authenticated Nango environment. Connection list results never include credentials. Getting a connection only includes credentials when the API key has the credential-reading scope.

| Tool               | Description                                                                                                                                           | Required API key scope                                                       |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `connections_list` | List and filter connections.                                                                                                                          | `environment:connections:list` or `environment:connections:list_credentials` |
| `connections_get`  | Get a connection and its current credential state. Credential access and refresh flags require `read_credentials` and may rotate credential material. | `environment:connections:read` or `environment:connections:read_credentials` |

### Logs

Use the Logs tools to find activity in the authenticated Nango environment and inspect the messages for a specific operation.

| Tool                   | Description                            | Required API key scope  |
| ---------------------- | -------------------------------------- | ----------------------- |
| `logs_list_operations` | List and filter log operations.        | `environment:logs:read` |
| `logs_get_operation`   | Get an operation and its log messages. | `environment:logs:read` |

See [Observability](/guides/platform/observability) for more information about Nango logs.