Skip to main content
This feature is available on Ultimate site plans.
GitBook Assistant gives your users fast, accurate answers about your documentation using natural language. It’s personalized to your users, can be embedded into your website or product, and is available in the sidebar of your published docs. Think of it as a product expert available to all of your users, in the places and times they need it most. The Assistant uses agentic retrieval to understand the context of queries based on the user’s current page, previously-read pages, and previous conversations.

​
Enable GitBook Assistant

To enable GitBook Assistant, open your site’s dashboard, navigate to the Settings page and choose AI & MCP from the menu on the left. Here you can enable GitBook Assistant from the options available.

​
Add suggested questions

Suggested questions are pre-written prompts shown when the Assistant opens with no active conversation. They help users understand what they can ask, and can help you point your users towards useful answers or workflows. You can add suggested questions in your site’s Settings, under the AI & MCP section. Best practices for suggested questions:
  • Start with a real user goal (setup, troubleshoot, integrate)
  • Use the words your users use (avoid internal codenames)
  • Keep them specific. “How do I…?” beats “Tell me about…”
  • Cover different intents: quickstart, how-to, troubleshooting, and reference
If you’re embedding the Assistant in your product, you can also dynamically set suggestions in your embed configuration.

​
Using GitBook Assistant in published docs

Users can access GitBook Assistant in three ways:
Press ⌘ + I on Mac or Ctrl + I on PC

​
Embed GitBook Assistant in your product

You can embed GitBook Assistant directly into your product or website, giving users instant access to AI-powered help without leaving your application. The Assistant can be embedded as part of Docs Embed, which includes both the Assistant tab for AI-powered chat and a Docs tab for browsing your documentation. Choose the embedding method that fits your stack:

Script tag

Quick setup with a <script> tag

Node.js/NPM

Server-side or build-time integration

React component

Prebuilt React components

​
Extend GitBook Assistant with MCP servers

You can also add external data sources to GitBook Assistant to give it more context and data to pull answers from. You can do this by connecting Assistant to MCP servers for external platforms, such as:
  • Your community (Slack, Discord, GitHub Communities etc)
  • Support tools (Intercom etc)
  • Your future product roadmap (GitHub, Linear etc)
  • Docs for external integrations with products

​
Add an MCP server

1

Open your site's settings

Navigate to your site dashboard and choose the Settings option from the site header. Then choose the AI & MCP section from the left-hand menu
2

Add a new server

At the bottom of the page is a table showing all the connected MCP servers. To add a new server, click Add MCP server
3

Configure your MCP server

To add your server you’ll need to give it a name, add the URL for the server, and configure the HTTP headers that will be sent along with the request to the server when a user submits a query.

Build docs developers (and LLMs) love

Get started for freeTalk to us