refactor: improve MCP debug message and code comment clarity

Copilot · EMaher · web-flow · commit beed54814ed6 · 2026-05-04T23:13:23.000Z
Agent-Logs-Url: https://github.com/Azure/apiops-cli/sessions/09cf004e-7aec-4a98-aefa-7700a7749a8d Co-authored-by: EMaher <9244742+EMaher@users.noreply.github.com>
diff --git a/src/services/api-extractor.ts b/src/services/api-extractor.ts
@@ -140,7 +140,7 @@ export async function extractApiResources(
     client, store, context, apiDescriptor, outputDir
   );
 
-  // Extract MCP server configuration (if enabled for this API)
+  // Extract MCP server configuration (singleton per API; silently skipped when not present)
   result.mcpServer = await extractApiMcpServer(
     client, store, context, apiDescriptor, outputDir
   );
@@ -245,7 +245,7 @@ async function extractApiSpecification(
   }
 
   if (apiType?.toLowerCase() === 'mcp') {
-    logger.debug(`OpenAPI does not apply to MCP APIs`);
+    logger.debug(`Skipping spec export for MCP API "${getNamePart(apiDescriptor.nameParts, 0)}" — MCP APIs use the Model Context Protocol endpoint, not OpenAPI`);
     return false;
   }
 

Original file line number	Diff line number	Diff line change
`@@ -140,7 +140,7 @@ export async function extractApiResources(`
`140`	`140`	`client, store, context, apiDescriptor, outputDir`
`141`	`141`	`);`
`142`	`142`
`143`		`- // Extract MCP server configuration (if enabled for this API)`
	`143`	`+ // Extract MCP server configuration (singleton per API; silently skipped when not present)`
`144`	`144`	`result.mcpServer = await extractApiMcpServer(`
`145`	`145`	`client, store, context, apiDescriptor, outputDir`
`146`	`146`	`);`
`@@ -245,7 +245,7 @@ async function extractApiSpecification(`
`245`	`245`	`}`
`246`	`246`
`247`	`247`	`if (apiType?.toLowerCase() === 'mcp') {`
`248`		- logger.debug(`OpenAPI does not apply to MCP APIs`);
	`248`	+ logger.debug(`Skipping spec export for MCP API "${getNamePart(apiDescriptor.nameParts, 0)}" — MCP APIs use the Model Context Protocol endpoint, not OpenAPI`);
`249`	`249`	`return false;`
`250`	`250`	`}`
`251`	`251`