Skip to main content

Configure extensions

This section explains how to configure Virtana Infrastructure Observability (IO) and Global View (GV) for use with MCP clients. MCP lets AI agents connect to Virtana product data through natural-language prompts, while each product uses its own endpoint and authentication method.

Configure the IO MCP extension

To enable communication between your AI tool and the IO Server, configure the MCP service to use HTTP as an extension. This setup allows the AI component to interact securely with underlying IO APIs.

To add the Virtana MCP extension, perform the following steps:

  1. In the client application (for example, Goose client), open the left navigation and select Extensions. See the Goose MCP extension for details.

  2. Click Add Custom Extension.

  3. Enter the extension name and enter the Type as Streamable HTTP.

    Note

    When you select HTTP as the type, the endpoint options become available.

  4. Enter endpoint/MCP URL as: https://<io_server>/api/sdk/mcp/.

  5. Navigate to request headers and add the following header:

    • Header Name: Authorization

    • Value: Bearer <Your_IO_API_Token>

  6. (Optional) Give the extension a meaningful name, such as Virtana IO_Server, so that users can recognize it.

  7. Save the configuration.

  8. When successfully activated, you will see all enabled extensions in the Extensions section.

  9. Start Testing in Chat.

    Note

    Many MCP clients require that the certificates of secure endpoints (HTTPS) be a valid and fully resolvable certificate. If your IO server is using the default self-signed certificate, configure a valid certificate for the IO instance, import the self-signed certificate into your application, or consider a reverse proxy. The best approach will depend on your environment and setup.

For detailed instructions on configuring AI capabilities in IO, see AI Configuration

Configure Global View MCP extension

Use this section to configure Global View (GV) for MCP clients. Global View uses OAuth client credentials for authentication, and the MCP client connects to the Virtana MCP endpoint with those credentials.

Configure your client

Set up the MCP endpoint and authentication headers required for your client to connect to Global View.

  1. Use the following MCP endpoint for Global View:

    https://app.cloud.virtana.com/mcp

  2. Add these request headers to your client:

    • client-id: <YOUR_CLIENT_ID>

    • client-secret: <YOUR_CLIENT_SECRET>

    If your client supports multiple MCP servers, you can keep this Global View connection enabled alongside other Virtana servers in the same workspace or session.

Add the extension

Register the Global View MCP server as a custom extension in your client application.

  1. In the client application (for example, Goose client), open the left navigation and select Extensions. See the Goose MCP extension for details.

  2. Click Add Custom Extension.

    add_extensions.png

  3. Enter the extension name and enter the Type as Streamable HTTP.

    Note

    When you select HTTP as the type, the endpoint options become available.

  4. Enter endpoint/MCP URL as: https://<your-platform-url>/mcp

  5. Navigate to request headers and add the following header:

    • client-id: <YOUR_CLIENT_ID>

    • client-secret: <YOUR_CLIENT_SECRET>

  6. Save the configuration.

  7. Start Testing in Chat.

In this section: