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.The assistant cannot connect to the MCP server
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.The browser sign-in or consent flow does not finish
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.
Ploti tools do not appear after connecting
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.
The session expired
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.
No parcel layers are available
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.
A dataset is marked locked
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.
An analysis is still running
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.
The interactive map or table is missing
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.
A download or artifact link expired
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.
The result looks incomplete or incorrect
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.
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
Connection guides
Recheck the setup steps for your assistant.
Security and privacy
Review access boundaries, retention, and revocation.