mcp_chatgpt_app_guide
Use the Zentrik ChatGPT app
Capture customer notes, discover repeated problems, and review evidence-backed opportunities from an authorized Zentrik workspace inside ChatGPT.
The Zentrik ChatGPT app is a focused Apps SDK surface for customer evidence and Discovery traceability.
Use it when you want ChatGPT to work with Zentrik evidence without opening the full product interface first.
- MCP server URL:
https://zentrik.ai/mcp/chatgpt - Auth: browser-based OAuth
- Scope: one ChatGPT connection = one Zentrik workspace
- Data boundary: reads and writes stay inside the authorized private Zentrik workspace
- V1 scope: tool-only, no embedded widget
The broader Zentrik MCP endpoint remains available at /mcp for Codex, Cursor, Claude, and other MCP-capable clients.
What it can do
The app exposes a narrow set of tools for evidence capture and evidence-backed review.
Capture evidence
Use the app to save customer notes, support summaries, interview snippets, or research observations into Zentrik as evidence records.
The write path is idempotent. ChatGPT provides a stable idempotency key for the source interaction, and repeated calls with the same key return the existing evidence record instead of creating duplicates.
Search and fetch context
Use search to find relevant evidence, findings, opportunities, and ideas. Use fetch on a search result to retrieve the full context that ChatGPT should summarize.
The search and fetch shapes follow the standard ChatGPT company-knowledge pattern: search returns fetchable IDs, and fetch returns text plus string metadata.
Review opportunity evidence
Ask what evidence supports a Zentrik opportunity when you need to understand why it exists before planning, prioritizing, or drafting.
The app returns compact opportunity context, linked findings, and relationship counts. It does not expose broad product graph editing or destructive update tools.
Check processing
New evidence may continue processing after it is created. Use the processing-status tool when ChatGPT returns a follow-up status handle.
Status responses are compact: they include the evidence record, processing state, and normalized result IDs without raw queue payloads or internal debug fields.
Review setup
For app review, use synthetic Zentrik data only. Do not include production customer evidence in screenshots or test prompt responses.
Synthetic workspace
The review account should choose the ChatGPT App Review workspace during OAuth.
That workspace contains synthetic evidence records, generated findings, and OPPORTUNITY-1 so reviewers can test evidence capture, repeated-problem summaries, search/fetch, and opportunity-evidence review without seeing customer data.
Review prompts
Useful review prompts:
- Create a Zentrik evidence record from these customer interview notes.
- What customer problems repeat across recent evidence in Zentrik?
- Search Zentrik for customer evidence about export workflows, then fetch the most relevant result.
- What evidence supports OPPORTUNITY-1?
The app should not trigger for unrelated calendar questions, public posting requests, or destructive product graph changes.
Troubleshooting
These items are about workflow and expectations in the product, not a broken OAuth client. If something contradicts what you see in your workspace, note your workspace name and the screen, then contact us.
ChatGPT cannot connect to the app
Confirm the server URL is exactly https://zentrik.ai/mcp/chatgpt, then retry OAuth. If the ChatGPT-specific endpoint returns 404, the app backend has not been deployed yet.
The wrong workspace is connected
Reconnect the app and choose the intended Zentrik workspace during OAuth. Each ChatGPT app connection is bound to one workspace.
Evidence was created twice
Use the same idempotency key when retrying evidence creation from the same source interaction. Reusing the key returns the existing evidence record.
New evidence is not visible in summaries yet
Evidence processing may continue after creation. Ask ChatGPT to check the evidence processing status before asking for downstream synthesis.