FAQs

What is an MCP server?

An MCP (Model Context Protocol) server is an external service that exposes tools OpsPilot can call to retrieve information from other systems, such as tickets, runbooks, logs, metrics, and dashboards.

Do I need to define the tools?

No. OpsPilot automatically discovers the server’s available tools and uses the ones relevant to your request.

Is the external data imported into OpsRamp?

No. Connecting a server does not import its data into OpsRamp. OpsPilot retrieves the information only when it answers your question.

Can I use a standard Jira, Splunk, or GitHub REST API URL as the Base URI?

No. The Base URI must be the URL of an MCP server, supplied by its provider. Confirm the exact path with the provider and use HTTPS for a hosted server.

Does each OpsPilot user connect with their own external account?

No. The integration stores one shared credential. OpsPilot can retrieve only what the configured account is allowed to see.

Which authentication types are supported?

Select None, Basic, or OAuth2 with REST API as the Notification Type. The UI may also show JWT, but this connector does not support JWT authentication.

What do I enter in the Password field for Basic authentication?

Enter a bearer token, not a standard HTTP Basic password. For OAuth2 Refresh Token, enter the provider’s refresh token. For Password Credentials, enter the provider account’s password.

Does changing the User Name change the external account OpsPilot uses?

No. The credential (for example, the refresh token) determines the account. Changing User Name alone does not change the authorized account or its permissions.

Can OpsRamp generate the OAuth client ID and refresh token for me?

No. The OpsRamp form does not generate these credentials or provide a browser login. Ask your administrator for an approved authorization process.

Which transport does the connector use?

A URL ending in /mcp uses Streamable HTTP. Otherwise, the connector tries SSE at <baseURI>/sse.

Which external systems have been verified?

The Jira + Confluence flow was tested with hosted Atlassian MCP. Splunk, ServiceNow, Prometheus, and Grafana are illustrative use cases and require a compatible MCP server registered in your environment.

How do I check that the server is connected?

Open OpsPilot and ask What external MCP servers are connected? Confirm the integration name appears.

At which scopes is the integration available?

Service Provider, Partner, and Client scopes.

Troubleshooting

Server not listed

  1. Confirm the integration is saved and enabled.
  2. Confirm you are working in the correct tenant.
  3. Confirm the connector is enabled in this environment.
  4. Verify the integration type is MCP_SERVER. The connector discovers enabled MCP_SERVER integrations by display name.

Tools cannot be listed

  1. Check the MCP endpoint and path in Base URI.
  2. Confirm the transport. A URL ending in /mcp uses Streamable HTTP; otherwise the connector tries SSE at <baseURI>/sse.
  3. Verify network egress and TLS connectivity to the server.
  4. Confirm the server accepts the configured bearer token or OAuth access token.

OAuth error

  1. Confirm the Access Token URL.
  2. Verify the Key (client ID) and Secret.
  3. Check the Grant Type and Scope.
  4. Confirm the refresh token is valid.
  5. If the provider rotated the refresh token, reauthorize. This connector does not currently persist a replacement refresh token returned by the token endpoint, so sustained use may require reauthorization or a token-rotation integration.

External resource returns 404/403

  1. Check that the configured external account can access the requested project, space, or repository.
  2. Update permissions on the external account if needed. Changing User Name alone does not change its permissions.

OpsPilot cannot execute a command

  1. Ask an administrator to check the OpsPilot sandbox and its CLI deployment.
  2. Note that this is different from an MCP server connection or permission error.

Security note: Secrets must be entered only through the authorized integration credential form. Do not paste refresh tokens, PATs, authorization codes, or decrypted notifier API responses into OpsPilot conversations, support tickets, or logs.