> ## Documentation Index
> Fetch the complete documentation index at: https://terrascout.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP troubleshooting

> Resolve Ploti MCP connection, authentication, session, data, and output issues

# Troubleshooting

Ploti returns specific recovery instructions with tool errors. If your assistant summarizes an error too aggressively, ask it to show the complete Ploti tool message.

<AccordionGroup>
  <Accordion title="The assistant cannot connect to the MCP server">
    Confirm the server URL is exactly `https://mcp.ploti.ai/api/mcp` and uses
    HTTPS. Remove any trailing text or copied punctuation. If the host cached a
    failed setup, remove the Ploti connection and add it again.
  </Accordion>

  <Accordion title="The browser sign-in or consent flow does not finish">
    Allow the browser to return to the assistant after approval. If you changed
    accounts mid-flow, restart the connection from the assistant. Managed
    workspaces may also require an administrator to allow custom connectors or
    developer mode.
  </Accordion>

  <Accordion title="Ploti tools do not appear after connecting">
    Start a new conversation and enable Ploti in the host's tools or apps menu.
    Some hosts snapshot tool metadata when a connector is added; remove and
    reconnect Ploti if the tool list remains stale.
  </Accordion>

  <Accordion title="The session expired">
    MCP sessions close after one hour without activity. Ask the assistant to
    start a new session and navigate to the relevant place. Saved checkpoints,
    tables, queries, filters, and files remain in the workspace.
  </Accordion>

  <Accordion title="No parcel layers are available">
    Parcel-level data requires a close enough map view. Ask the assistant to
    navigate closer to the city, neighborhood, address, or coordinates, then
    list the available layers again. A broad regional view intentionally exposes
    fewer parcel-level datasets.
  </Accordion>

  <Accordion title="A dataset is marked locked">
    Free MCP workspaces can query nationwide U.S. parcel data and use ordinance
    research. Other datasets may require a paid Ploti plan. Ploti reports locked
    layers explicitly and provides the upgrade path only when the request needs
    that data.
  </Accordion>

  <Accordion title="An analysis is still running">
    Longer analysis automatically becomes a background job. Let the assistant
    poll the existing job instead of rerunning it. Jobs can run for up to 15
    minutes, and executions within one session run one at a time.
  </Accordion>

  <Accordion title="The interactive map or table is missing">
    Some MCP hosts render only text results. The assistant should still receive
    a compact preview and an **Open in Ploti** link. If a normally supported
    host shows a blank panel, reconnect Ploti to refresh its cached UI template.
  </Accordion>

  <Accordion title="A download or artifact link expired">
    Ask the assistant to list the session's saved outputs and show the artifact
    again, or open the workspace in Ploti. Artifact view grants expire, while
    the saved workspace artifact follows normal workspace retention.
  </Accordion>

  <Accordion title="The result looks incomplete or incorrect">
    Ask the assistant to name the source layers, map viewport, filters, and
    missing fields. Broaden or narrow the viewport as needed. Verify material
    property and ordinance facts with the cited primary source.
  </Accordion>
</AccordionGroup>

## Collect useful details for support

Before contacting support, include:

* Assistant and surface, such as Claude web, ChatGPT web, or Codex CLI
* Approximate time and time zone of the failure
* The Ploti workspace name
* The complete error message
* The session ID or job ID, if the assistant displayed one
* Whether reconnecting in a new conversation changed the result

Never send access tokens, refresh tokens, passwords, or browser cookies.

Contact [support@ploti.ai](mailto:support@ploti.ai) for product or security concerns.

<CardGroup cols={2}>
  <Card title="Connection guides" icon="plug" href="/docs/mcp/overview">
    Recheck the setup steps for your assistant.
  </Card>

  <Card title="Security and privacy" icon="shield-halved" href="/docs/mcp/security-and-privacy">
    Review access boundaries, retention, and revocation.
  </Card>
</CardGroup>