Use This Doc For
/platform/tools/platform/tools/built-ins/platform/tools/catalog/platform/tools/catalog/sync/platform/tools/integrations/platform/tools/integrations/google-business-profile/platform/tools/integrations/google-marketing-intelligence/platform/tools/inventory/platform/tools/services/platform/services/platform/integrations- Address validation provider choice (Smarty vs Mapbox) — see Address Validation Providers
Start With The Object You Are Managing
“Available,” “configured,” and “usable by this coworker now” are different claims. Choose the surface that owns the claim:
| Surface | What it represents | It does not prove |
|---|---|---|
| Tool Marketplace / Catalog | Known MCP and agent-tool options plus setup and grant guidance | That a service is connected or executable |
| MCP Services | Registered service endpoints and the tools they expose | That a particular coworker has the required grant |
| Native Integrations | Business-system connections on DPF’s shared credential and governance substrate | That every provider operation is supported or write-enabled |
| Built-in Tools | First-party utilities shipped with the platform | That a specific workflow has been granted access |
| Capability Inventory | Runtime inventory of internal tools, MCP tools, and AI providers already registered for agents; inventory review counts use canonical discovered entities | That catalog setup or a provider account is healthy |
| Estate Discovery | Network collectors and the evidence they produce | That a discovered item is already governed in Portfolio |
Read Marketplace Readiness
Select the coworker whose readiness you are evaluating before acting on a status:
- Ready — the current setup, model, and grant checks found no missing prerequisite for that marketplace entry.
- Needs setup — configure the service, provider, model, or other connection prerequisite.
- Needs grant — the service can exist while the selected coworker still lacks one or more required grants.
- Blocked — a platform condition prevents readiness; inspect the displayed reason rather than repeating setup.
Catalog sync refreshes known tool metadata. It does not configure credentials, activate a service, grant a coworker access, or prove runtime health.
Connect And Verify
- Identify whether the capability should run through an MCP service, a native provider integration, or a built-in tool. Do not create a second connection path for a provider already owned by a native integration.
- In the catalog, review category, pricing, applicable archetype, selected coworker, and readiness gaps.
- Configure the owning service or integration with the narrowest provider account and permissions that support the intended workflow. Only authorized administrators can enable services and provider connections.
- Return to the catalog or capability inventory and verify that registration, setup, and coworker grant state agree.
- Exercise a read-only preview or the smallest safe operation. Record which account, object scope, and freshness window the preview represents.
- For side-effecting use, verify the coworker’s grant and approval posture, then confirm the resulting proposal and execution evidence under Governance & Audit.
Review Tools A Service Discovers
When you connect an MCP service, the tools it reports start as Waiting for review. Coworkers cannot see or use them yet: a working connection is not permission.
- Open Platform > Tools > Services and choose the service.
- Expand a tool to read exactly what a coworker would read: its description and inputs, with hidden characters removed.
- Choose the permission a coworker needs to use it, and say whether it only reads information or can change things outside the platform.
- Select Approve this text, or Block if coworkers should never use it.
If the service later changes an approved tool’s description or inputs, the tool goes back to Waiting for review and is marked Changed since approval. Coworkers keep seeing nothing new until you review it again; the page shows the approved text and the new text side by side. Return to review withdraws an approval immediately. Tools that ship with the platform show Included; their access is set by the release.
Native Integration Previews
Native integration pages use customer-supplied credentials and expose connection state such as connected or error. Their preview cards are read-first operational evidence: for example, a finance integration may show company, customer, invoice, balance, or payment context, while a marketing integration may show account, audience, campaign, traffic, search, listing, or lead context.
Before relying on a preview, confirm:
- the named provider and connected account are the intended ones;
- the credential has the required provider scopes;
- the page states whether the view is read-only;
- the displayed data has a visible or otherwise defensible freshness window; and
- the coverage matrix marks the required object or operation as supported.
An integration can be connected while a particular operation remains unsupported. Capability support must be explicit; absence of an error is not proof of support.
Troubleshooting And Recovery
- Catalog entry, no service — complete setup on the owning MCP service or native integration page.
- Service active, coworker not ready — resolve the named missing grant or model prerequisite; do not duplicate the service.
- Connected integration, empty preview — verify provider account scope, permissions, and freshness before changing DPF authority.
- Integration error — repair or rotate the provider credential and retest the smallest read path. Preserve the error evidence needed to explain the outage.
- Capability inventory empty or stale — use the governed sync/deploy path that populates platform capabilities. Do not treat an empty inventory as proof that the tools were removed from every runtime.
- Inventory review count looks lower after an integrity repair — normal tools and discovery surfaces exclude retained superseded records. Follow an entity-detail link to its canonical record. Repair provenance is retained as operational evidence; it is not another live item in the Tools view.
- Provider operation unsupported — follow the explicit unsupported status and use a documented alternative. Do not infer write support from read coverage.
What To Watch
- inventory entries that exist but are not usable from governed routes
- sync operations that refresh metadata without updating route expectations
- service activation attempts without matching documentation or trust guidance
- provider previews that show data without making account scope, freshness, or read-only status clear
- duplicate MCP and native connections for the same provider responsibility
- credentials broader than the workflow requires
- a connected badge being mistaken for coworker readiness
- missing capability flags being mistaken for silent success
- troubleshooting a provider failure by widening platform authority