- Otto investigations use the servers that an Organization Owner enables in Investigation Agent MCP Access.
- Otto Routines use the servers that you select in each Routine.
Prerequisites
- The Organization Owner role to register, edit, or delete servers, and to enable servers for investigations. Users with the Organization Member role can view the servers and use them, but can’t register, edit, or delete them.
- AI features enabled for your Organization. See Toggle AI features for your Organization.
- An MCP server that is reachable at a public
httpsendpoint and that uses the Streamable HTTP or the Server-Sent Events (SSE) transport. Astro doesn’t connect to private or internal addresses, and rejects plainhttp. - A read-only token for the MCP server. Routines run with the token’s full access. See What MCP servers allow a run to do.
- If your MCP server limits access by IP address, the Astronomer egress IP addresses in its allowlist. Astronomer publishes these addresses as the DNS A records of
egress.astronomer.io. To get the current list, rundig +short egress.astronomer.io.
Register a server
1
Open the MCP server list
In the Astro UI, click Organization Settings.In the AI section, click MCP Servers.
2
Enter the server details and create the server
Click New MCP Server, then complete the following fields:
Click Create MCP Server.
Check the status of a server
The MCP Servers list shows the status of each server. Astro checks the status when you open the list. A new server takes about a minute to become reachable. Until then, its status is Pending or Not found.Grant the investigation agent access
Registering a server doesn’t give Otto investigations access to it. Every server starts disabled for investigations until an Organization Owner enables it.- In the Astro UI, click Organization Settings.
- In the AI section, click Investigation Agent MCP Access.
- Select each server that investigations can use. To select all servers, select the Select all servers checkbox.
- Click Save.
Edit a server
Go to Organization Settings > MCP Servers, click the actions menu in the server’s row, then click Edit MCP Server.- You can’t change the name. Routines reach a server’s tools by its name prefix, so a new name breaks them. To use a different name, register a new server.
- To keep the current credential, leave Credential blank. To replace it, enter a new credential.
- When you change the URL, you must enter the credential in the same save, even if the credential doesn’t change.
- You can change the description, the transport, and investigation access separately.