docs: disambiguate Mendix Catalog (CLI) from MDL CATALOG keyword

Add prominent warnings in:
- catalog-search.md skill: clarify this is the external service registry
- browse-integrations.md skill: clarify this is MDL CATALOG for local queries
- cmd_catalog.go: add disambiguation note in CLI help text
- PROPOSAL_catalog_integration.md: add terminology note at top

This prevents confusion between:
1. Mendix Catalog (catalog.mendix.com) - external service registry, CLI commands
2. MDL CATALOG keyword - local project metadata tables, SQL queries

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: dionesiusap

.claude/skills/mendix/browse-integrations.md

@@ -1,6 +1,8 @@
 # Browse Integration Services and Contracts
 
-This skill covers discovering external services, browsing cached contracts, and querying integration assets via the catalog.
+This skill covers discovering external services, browsing cached contracts, and querying integration assets via the **MDL CATALOG** (local project metadata).
+
+**⚠️ NOTE:** This covers the **MDL CATALOG keyword** (`SELECT ... FROM CATALOG.entities`), NOT the **Mendix Catalog CLI** (`mxcli catalog search`). See `.claude/skills/mendix/catalog-search.md` for the external service registry.
 
 ## When to Use This Skill
 

.claude/skills/mendix/catalog-search.md

@@ -1,6 +1,8 @@
-# Catalog Search
+# Catalog Search (Mendix Platform Service Registry)
 
-Search and discover services registered in Mendix Catalog programmatically.
+Search and discover services registered in **Mendix Catalog** (catalog.mendix.com) programmatically.
+
+**⚠️ NOTE:** This is the **external Mendix Catalog service** (CLI: `mxcli catalog search`), NOT the **MDL CATALOG keyword** which queries local project metadata tables (`SELECT ... FROM CATALOG.entities`). See `.claude/skills/mendix/browse-integrations.md` for MDL CATALOG queries.
 
 ## Authentication Required
 
@@ -142,7 +144,26 @@ Phase 2 (not yet implemented):
 
 See GitHub issue #213 for architecture discussion.
 
+## Disambiguation: Two Different "Catalogs"
+
+**Mendix Catalog** (this skill):
+- **What**: External service registry at catalog.mendix.com
+- **CLI**: `mxcli catalog search "customer"`, `mxcli catalog show <uuid>`
+- **Purpose**: Discover OData/REST/SOAP services across your organization
+- **Requires**: Platform authentication (PAT token)
+- **Data source**: Mendix cloud service
+
+**MDL CATALOG keyword** (different concept):
+- **What**: Local project metadata tables in the mxcli SQLite database
+- **MDL syntax**: `SELECT ... FROM CATALOG.entities`, `SHOW CATALOG TABLES`
+- **Purpose**: Query project structure (entities, microflows, pages, etc.)
+- **Requires**: `REFRESH CATALOG` command (no auth needed)
+- **Data source**: Your local .mpr file
+
+See `.claude/skills/mendix/browse-integrations.md` for MDL CATALOG usage.
+
 ## Related
 
 - Platform authentication: `.claude/skills/mendix/platform-auth.md`
 - OData client creation: `.claude/skills/mendix/odata-data-sharing.md`
+- MDL CATALOG queries: `.claude/skills/mendix/browse-integrations.md`

cmd/mxcli/cmd_catalog.go

@@ -15,8 +15,12 @@ import (
 
 var catalogCmd = &cobra.Command{
 	Use:   "catalog",
-	Short: "Search and manage Mendix Catalog services",
-	Long: `Search for data sources and services registered in Mendix Catalog.
+	Short: "Search and manage Mendix Catalog services (catalog.mendix.com)",
+	Long: `Search for data sources and services registered in Mendix Catalog (catalog.mendix.com).
+
+NOTE: This is the external Mendix Catalog service, NOT the MDL CATALOG keyword.
+  - CLI catalog commands: Search external service registry (requires auth)
+  - MDL CATALOG keyword: Query local project metadata (SELECT ... FROM CATALOG.entities)
 
 Requires authentication via Personal Access Token (PAT). Create a PAT at:
   https://user-settings.mendix.com/

docs/11-proposals/PROPOSAL_catalog_integration.md

@@ -4,6 +4,8 @@
 **Date:** 2026-04-16  
 **Author:** Generated with Claude Code  
 
+**⚠️ TERMINOLOGY NOTE:** This proposal covers the **external Mendix Catalog service** at catalog.mendix.com (CLI: `mxcli catalog search`), which is separate from the **MDL CATALOG keyword** used for querying local project metadata (`SELECT ... FROM CATALOG.entities`). The two concepts are unrelated despite sharing the name "catalog".
+
 ## Problem
 
 Mendix Catalog (catalog.mendix.com) is the centralized registry for discovering data sources and services across an organization's landscape. It indexes OData services, REST APIs, SOAP services, and Business Events published by Mendix applications and external systems.