Works with ChatGPT
Your docs
as a ChatGPT plugin
Add a Revdoku docs site to ChatGPT as a custom MCP plugin. ChatGPT then finds the right page of your docs and answers from it. Add your Revdoku account as a second plugin, and ChatGPT can also read your support tickets.
- Publishes from GitHub on every push
- Works with Mintlify repositories
- API console from your OpenAPI file
- MCP server and llms.txt for AI agents
- Ask AI and support tickets
- Analytics for people and AI agents
Add a docs site to ChatGPT
ChatGPT uses outside services through plugins. A plugin can contain an MCP server. MCP is a standard way for AI apps to use outside tools. Each public Revdoku docs site has its own MCP server at /mcp. It is read-only and needs no account.
- On the web, go to ChatGPT Plugins.
- Select the plus button, then Add custom MCP server. If the option is missing and your workspace allows it, turn on Developer mode in Settings → Security and login.
- Type a name for the docs, for example
Acme docs. Under Connection, type the site address with/mcpat the end:https://docs.example.com/mcp - For authentication, choose No authentication.
- Read the risk warning. Select I understand and want to continue, then Create as a plugin.
- Install the new plugin. In a new chat, type
@and select the docs plugin. Then ask your question.
ChatGPT gets three tools. search_docs finds the pages that match a question, with the matching section. read_page reads one page as Markdown, and list_pages lists all pages in order. The tools read the live site. So ChatGPT gets each change after you publish it, without a refresh of the plugin.
Your readers can add a public docs site to ChatGPT in the same way.
Connect your Revdoku account to ChatGPT
The docs plugin only reads a site. To read your support tickets and manage your docs sites from ChatGPT, add the Revdoku server of your account as a second plugin. This server uses sign-in.
- Create a Revdoku account with Google, GitHub or your email address.
- In ChatGPT Plugins, add one more custom MCP server. Name it
Revdoku. Under Connection, typehttps://mcp.revdoku.com - For authentication, choose OAuth. Then confirm the risk warning and select Create as a plugin.
- Install the plugin. When ChatGPT asks you to connect it, sign in to Revdoku.
- On the Revdoku permission screen, select the buckets that ChatGPT can use. Select an access level from the table that follows. Then click Connect.
- In a new chat, type
@and select Revdoku. Ask: “List my Revdoku buckets and the address of each docs site.”
A bucket holds the files of one docs site, the site and its support tickets.
| Access level | What ChatGPT can do |
|---|---|
| Read only | Read the files, the site status and the support tickets. |
| Read & write | Also reply to support tickets, and save files. |
| Full access | Also publish, preview and unpublish sites, create buckets and delete email. |
If a bucket gets its files from GitHub, change the docs in the repository. The Edits in Revdoku setting of the bucket decides what happens to an edit that ChatGPT makes in Revdoku: it waits for a person, becomes a commit, or Revdoku refuses it.
You add each plugin once. OpenAI says that plugins work in Chat and Work on the web, in the desktop app and on mobile. The desktop app also keeps a separate list of MCP servers in Settings → MCP servers, which it shares with the Codex CLI. The Codex page explains that list.
What ChatGPT can do with your docs and support tickets
- Ask how a part of your API works. ChatGPT searches the docs, reads the matching page and answers with a link to it.
- Ask for code. ChatGPT reads the reference page of an operation and writes a call with its parameters.
- With the account plugin, ask about new support tickets. ChatGPT names the docs page that answers each question.
- Ask which questions no page answers. Then you know which page to write next.
- Ask for a reply to a support ticket. ChatGPT shows you a draft first. After you approve it, ChatGPT sends it in the same thread.
Revdoku sends only replies. Each reply goes to the person who opened the ticket. A prompt to start with:
@Revdoku Find the bucket of my docs site. Read the support tickets of the last 14 days. Group the questions by topic. For each topic, name the docs page that answers it, or say that no page answers it. Do not reply to anyone.
Account rules, refresh and removal
OpenAI's guide to custom MCP servers says that account and workspace policies apply when you add and use one. In a workspace, admins control who can use a connection.
If your ChatGPT account cannot add a plugin, give ChatGPT the docs as a file. Open https://docs.example.com/llms-full.txt, the file with every page of the site, and save it. Then attach it to a chat.
When Revdoku adds new tools, open the Revdoku plugin in Plugins and select Refresh. Then start a new chat. To remove a plugin, open it and select Uninstall plugin. OpenAI notes that the MCP connection stays in ChatGPT until you disconnect it there. In Revdoku, Account → Access lists the ChatGPT connection to your account.
Give a ChatGPT dot your docs
A dot is an always-on ChatGPT agent with its own cloud computer and browser. OpenAI offers dots to Pro, Business Premium and Enterprise accounts. Pro access is for adults outside the EEA, the UK and Switzerland. In Enterprise workspaces, an admin controls access (OpenAI's guide to dots).
A dot uses the supported plugins that are installed and enabled for your account. Install the docs plugin and the Revdoku plugin with the steps on this page. Then name the docs site in your request. Your plugin permissions also apply to the dot. Custom rules add another limit. On the web or in the desktop app, open Settings → Personalization and select Custom rules under Permissions. For replies to support tickets, choose Ask before taking action.
Revdoku does not push new support tickets into ChatGPT. Ask the dot for a saved schedule, with a time zone and an end date. To review the schedule later, open Scheduled. A prompt to try:
Each weekday at 9 AM Eastern until December 19, read the new support tickets of my Revdoku docs site. For each ticket, search the Acme docs and draft a reply with a link to the page that answers it. Send me the drafts. Ask me before you send a reply to anyone.
OpenAI plugins guide · OpenAI: add a custom MCP server · Docs for AI agents · Revdoku MCP guide