comol/ai_rules_1c/mcp-1c-tools

MCP tools for 1C — router

Apply content/rules/mcp-policy.md → Tool availability before routing: .dev.env TOOL_* policy plus callable tools and verified scope. Config entries alone prove nothing. The same policy owns obligations, budgets and typed-error recovery. Search: content/rules/mcp-first-search.md; task sequences: content/rules/tooling-playbooks.md.

Project scope is part of the call. For extensions or a multi-project graph, first match the current source roots to a returned base project_id through list_graph_projects (content/rules/multi-contour-search.md). Supply it explicitly on every graph project-data call that exposes it, including paging and evidence. Resolve extension-layer coverage separately. Use each other server's actual selector (configurationId or another field only if exposed); its identifiers are not interchangeable with graph IDs. If a tool has no explicit selector, require a verified fixed/session/entity scope or use a suitable scoped tool/fallback. Never invent unsupported parameters or accept a default/foreign project as the current one. Reuse a valid mapping until the workspace/server context changes.

Need → operation skill

Load the skill for the operation, not this whole catalogue. Each skill lists the exact argument names of its tools and example calls; no schema fetch is needed for a tool it names.

Server catalog

The operation table above is sufficient for ordinary routing. Read server-catalog.md only to identify an unfamiliar server/alias, find a server-specific reference, or select an optional pre-alpha integration. Do not load the whole catalog before a known operation.

Fallback chain

Project source (code, metadata, usages, forms, file locations): within verified contour coverage, graph → mapped code-metadata → scoped native Grep / Glob / Read after a bounded miss, with a one-line fallback note. Code chooses its file-scan fallback internally; current tools have no grep input. Skip uncovered lanes; no eligible exposed index means native search in that contour immediately. Owner: content/rules/mcp-first-search.md; multiple roots, catalog/scope selectors and acceptance: content/rules/multi-contour-search.md.

External knowledge has no interchangeable fallback chain. Select only the relevant eligible provider. Missing templates: disclose no template check; memory: project-memory.md; routed standards: help-corpus-retrieval.md; validators/live IB: verification-gates.md. An unavailable source never proves API absence or a passed check; block dependent design when authoritative facts are missing.

Open docs/<server>.md once per server per session and only for a mode or response shape the operation skill does not cover; the environment descriptor wins over any document here.