Method test

src/node/services/mcpServerManager.ts:1288–1401

* Test an MCP server. * * Provide either: * - `name` to test a configured server by looking up its config, OR * - `command` to test an arbitrary stdio command, OR * - `url`+`transport` to test an arbitrary HTTP/SSE endpoint.

(options: {
    projectPath: string;
    /** Whether repo-local MCP config is allowed for this project. */
    trusted?: boolean;
    name?: string;
    command?: string;
    transport?: MCPServerTransport;
    url?: string;
    headers?: Record<string, MCPHeaderValue>;
    projectSecrets?: Record<string, string>;
  })

   * - `url`+`transport` to test an arbitrary HTTP/SSE endpoint.
   */
  async test(options: {
    projectPath: string;
    /** Whether repo-local MCP config is allowed for this project. */
    trusted?: boolean;
    name?: string;
    command?: string;
    transport?: MCPServerTransport;
    url?: string;
    headers?: Record<string, MCPHeaderValue>;
    projectSecrets?: Record<string, string>;
  }): Promise<MCPTestResult> {
    const isTransportAllowed = (t: MCPServerTransport): boolean => {
      return !this.policyService?.isEnforced() || this.policyService.isMcpTransportAllowed(t);
    };
    const {
      projectPath,
      trusted = false,
      name,
      command,
      transport,
      url,
      headers,
      projectSecrets,
    } = options;
    const trimmedName = name?.trim();

    if (trimmedName && !command?.trim() && !url?.trim()) {
      const servers = await this.configService.listServers(projectPath, trusted);
      const server = servers[trimmedName];
      if (!server) {
        return { success: false, error: `Server "${trimmedName}" not found in configuration` };
      }

      if (!isTransportAllowed(server.transport)) {
        return { success: false, error: "MCP transport is disabled by policy" };
      }

      if (server.transport === "stdio") {
        return runServerTest(
          { transport: "stdio", command: server.command },
          projectPath,
          `server "${trimmedName}"`
        );
      }

      try {
        const resolved = resolveHeaders(server.headers, projectSecrets);

        const authProvider = await this.mcpOauthService?.getAuthProviderForServer({
          serverName: trimmedName,
          serverUrl: server.url,
        });

        return runServerTest(
          {
            transport: server.transport,
            url: server.url,
            headers: resolved.headers,