# Zuwiki

## MCP Server

> Category: Integrations

---

## Pages

- [Welcome to Zuwiki](https://docs.zuwiki.com/welcome-to-zuwiki)

### Getting started

- [Create your first wiki](https://docs.zuwiki.com/getting-started/create-your-first-wiki)

### Core concepts

- [Wikis, categories, and pages](https://docs.zuwiki.com/core-concepts/wikis-categories-and-pages)
- [Page lifecycle](https://docs.zuwiki.com/core-concepts/page-lifecycle)
- [Page history and restore](https://docs.zuwiki.com/core-concepts/page-history-and-restore)

### Access & Sharing

- [Public vs internal wikis](https://docs.zuwiki.com/access-sharing/public-vs-internal-wikis)
- [Visibility for public wikis](https://docs.zuwiki.com/access-sharing/visibility-and-access)
- [Share links](https://docs.zuwiki.com/access-sharing/share-links)
- [Access grants](https://docs.zuwiki.com/access-sharing/access-grants)
- [Classification and sensitivity](https://docs.zuwiki.com/access-sharing/classification-and-sensitivity)

### Editor guide

- [Markdown basics](https://docs.zuwiki.com/editor-guide/markdown-basics)
- [Linking between pages](https://docs.zuwiki.com/editor-guide/linking-between-pages)
- [Icons and images](https://docs.zuwiki.com/editor-guide/icons-and-images)
- [Rich content blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Custom domain](https://docs.zuwiki.com/plans-account/custom-domain)
- [Zuwiki for open source](https://docs.zuwiki.com/plans-account/zuwiki-for-open-source)

### Integrations

- [MCP Server](https://docs.zuwiki.com/integrations/mcp-server)

---

# MCP Server

Zuwiki has a hosted MCP server, the Model Context Protocol endpoint that lets an AI assistant read and edit your wikis for you. Connect it once and you can ask things like "add a troubleshooting section to the onboarding page". The change lands in your wiki and is saved to the history just like a manual edit.

## Connecting

The server address is the same for every client:

```
https://mcp.zuwiki.com/mcp
```

That is all you need. There is no API key to copy. You sign in with your Zuwiki account in the browser, and your client registers itself automatically. You need a Zuwiki account that belongs to at least one organization.

### Claude Code

```bash
claude mcp add --transport http zuwiki https://mcp.zuwiki.com/mcp
```

Then open Claude Code, type `/mcp`, select **zuwiki** and choose **Authenticate**.

### Claude Desktop

Open **Settings**, then **Connectors**, choose **Add custom connector**, name it `Zuwiki`, paste the URL and click **Connect**.

### Codex

```bash
codex mcp add zuwiki --url https://mcp.zuwiki.com/mcp
codex mcp login zuwiki
```

Signing in to a remote server needs the rmcp client. Make sure your `~/.codex/config.toml` contains this:

```toml
experimental_use_rmcp_client = true

[mcp_servers.zuwiki]
url = "https://mcp.zuwiki.com/mcp"
```

On recent Codex versions the flag is written as `rmcp_client = true` under `[features]`.

### Cursor

Add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project, then click the login prompt Cursor shows:

```json
{
  "mcpServers": {
    "zuwiki": {
      "url": "https://mcp.zuwiki.com/mcp"
    }
  }
}
```

### VS Code with GitHub Copilot

Add this to `.vscode/mcp.json` in your project, or open your user configuration with **MCP: Open User Configuration**, then press **Start** above the entry:

```json
{
  "servers": {
    "zuwiki": {
      "type": "http",
      "url": "https://mcp.zuwiki.com/mcp"
    }
  }
}
```

### Other clients

Any client that supports remote MCP servers over HTTP works the same way. Add a server, choose the HTTP transport (sometimes called "streamable HTTP") and paste the URL. The client finds the login by itself.

## Signing in

Your browser opens a consent screen that names the app asking for access and what it may do: read your wikis and edit them. Click **Allow**, and the connection stays active until you remove it. You only do this once per client.

An assistant never has more rights than you. It sees and changes exactly what you can, and your role in each organization applies on its own.

## Working with an assistant

You can belong to several organizations with several wikis each, so tell the assistant where to work first:

> List my Zuwiki organizations.

> Use the "The Zu Company" organization and show me its wikis.

After that, just say what you want:

- "Create a page called Release notes under the Guides category."
- "Read the Getting started page and fix any typos."
- "Rename Intro to Introduction and move it to the top."
- "Show me the history of this page and restore yesterday's version."

The assistant can browse organizations, wikis and their structure, read pages, settings and history, create, rename, move and delete pages and categories, update content, switch pages between draft and published, and restore earlier versions. Every write follows the same rules as the editor.

## Good to know

**Every save is versioned.** An assistant's edits show up in the [page history](/core-concepts/page-history-and-restore) like yours, so anything can be rolled back.

**One organization at a time.** The active organization is remembered per session, so switching in one client doesn't affect another.

**Rate limits.** If a long run hits the limit per minute, the assistant waits a moment and carries on.

## Disconnecting

Remove the Zuwiki server from your client. In Claude Code that is `claude mcp remove zuwiki`, in Codex `codex mcp logout zuwiki` followed by `codex mcp remove zuwiki`. In Claude Desktop remove the connector under **Settings**, then **Connectors**. In Cursor or VS Code delete the `zuwiki` entry from `mcp.json`.

## Troubleshooting

- **The browser doesn't open, or sign in loops.** Make sure you are signed in to Zuwiki in that browser, then start the connection again from your client.
- **"Forbidden" or "not a member".** The assistant tried an organization you don't belong to. Ask it to list your organizations and pick one of those.
- **A change doesn't show up.** Reload the wiki in the app.
