Tettra's MCP connection lets you use an AI assistant — like Claude or Codex — to work with your wiki using plain language. Instead of clicking around, you can simply ask your assistant to find an answer, summarize a page, or draft a new one, and it will do it right inside Tettra.

This guide walks you through what it does, how to turn it on, and how to use it.

What you can do with it

Once connected, your AI assistant can:

• Search your wiki — "Find our refund policy" or "What pages do we have about onboarding?"
  
• Read a page — "Summarize the PTO policy page for me"
  
• Browse your categories and folders — "What's in the Customer Support category?"
  
• Create a new page — "Write a how-to for resetting email passwords and save it to Tettra"

• Create a page draft - 'Write a draft on how to...'
  
  

A few important things to know:

• It respects your permissions. The assistant can only see and do what you can do in Tettra. If you don't have access to a category or page, neither does your assistant.
  
• New pages are saved as Drafts by default. When the assistant creates a page, it lands in your Drafts for you to review and publish — nothing goes live automatically unless you ask it to.
  
• Your key acts as you. Anything done through the connection is done as your user account.
  
  

Before you start

The MCP connection needs to be enabled for your team. If you don't see the MCP API Key option (described below), or you see a message that says "MCP access is not enabled for your team," reach out to your account admin or Tettra support to have it turned on. (Available on Scaling plans and up)

Step 1: Generate your MCP key

Your MCP key is what securely links your AI assistant to your Tettra wiki.

1. Go to your account's API Keys settings page.
   
2. Find the MCP API Key section.
   
3. Click Generate MCP Key.

Now copy the install command (or vary it for your provider) and install. 

Will the AI change or delete my existing pages?
No. The connection can search, read, and create pages. Created pages are saved as drafts for your review by default.

Can my teammates see what I do through it?
The connection uses your own permissions and account. Drafts and pages you create follow Tettra's normal sharing rules.

I lost my key — can I see it again?
For security, generate a new one with Re-generate MCP Key and update your AI client with the new key.