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.