Perfect Wiki

Connect your Perfect Wiki knowledgebase to Claude (and other MCP-compatible clients) via the Perfect Wiki MCP server. Once connected, Claude can read, search, and manage pages in your knowledgebase directly from the chat.

Prerequisites

• A Perfect Wiki account with a knowledgebase
• An API token (Bearer token) scoped to the knowledgebase you want to expose
• An MCP-compatible client (Claude Code, Claude Desktop, Cursor, Windsurf, etc.)

The MCP server endpoint is:

https://api.perfectwiki.xyz/mcp

Claude Code

Run the following command in your terminal to register the Perfect Wiki MCP server:

claude mcp add --transport http -s user perfect-wiki https://api.perfectwiki.xyz/mcp \
  --header "Authorization: Bearer your-api-token"

Replace your-api-token with the token from your Perfect Wiki settings.

Tip: the -s (--scope) flag controls where the server configuration (including your API token) is stored:

• -s local (default) — saved to the current project only. Good if the token should not leave this project.
• -s user — saved to your user-level Claude config (~/.claude.json), so the server is available across all your projects on this machine. Recommended if you want to configure it once and reuse it everywhere.
• -s project — saved to .mcp.json in the project and checked into git. Avoid this for tokens, since the file is shared with your team.

Tip: you can register multiple Perfect Wiki knowledgebases side-by-side — just give each one a unique server name (the third argument to claude mcp add) and use the API token for the matching knowledgebase. A useful convention is perfect-wiki-[kb-name], for example:

claude mcp add --transport http -s user perfect-wiki-human-resources-kb https://api.perfectwiki.xyz/mcp \
  --header "Authorization: Bearer hr-kb-token"

claude mcp add --transport http -s user perfect-wiki-engineering-kb https://api.perfectwiki.xyz/mcp \
  --header "Authorization: Bearer eng-kb-token"

claude mcp add --transport http -s user perfect-wiki-sales-kb https://api.perfectwiki.xyz/mcp \
  --header "Authorization: Bearer sales-kb-token"

Claude will then expose each knowledgebase's tools under its own namespace, so you can ask it to search or update a specific knowledgebase by name.

Claude Desktop, Cursor, Windsurf

Add the following entry to your MCP configuration file:

{
  "mcpServers": {
    "perfect-wiki": {
      "type": "http",
      "url": "https://api.perfectwiki.xyz/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

Restart the client after saving the configuration.

Verifying the connection

Once configured, your client should expose Perfect Wiki tools such as:

• get_knowledgebase — get info about the connected knowledgebase
• list_pages — list all pages
• get_page — read a specific page
• create_page — create a new page
• update_page — update an existing page
• delete_page — delete a page
• ask — ask a natural-language question against your knowledgebase

Try asking your assistant: "List the pages in my Perfect Wiki knowledgebase."

FAQ

Where do I get an API token?

Open the Perfect Wiki settings for the knowledgebase you want to expose and generate a Bearer token there. Each token is scoped to a single knowledgebase.

Can one token access multiple knowledgebases?

No. Tokens are scoped to a single knowledgebase. To connect several knowledgebases, generate a token per knowledgebase and register each one as a separate MCP server (see the multi-KB tip above).

Can Claude delete or overwrite my pages?

Yes — the server exposes create_page, update_page, and delete_page tools, and any client connected with a valid token can call them. Most MCP clients will ask for your confirmation before running a write tool, but if you want a read-only setup, use a read-only API token.

Is my knowledgebase content sent to the LLM provider?

Yes. When you ask Claude (or another MCP client) a question, the tool results it pulls from Perfect Wiki are passed to the LLM as part of the conversation, following your LLM provider's data policy. The Perfect Wiki MCP server itself only forwards the requests your client makes.

What happens if I lose or leak my token?

Revoke it from Perfect Wiki settings and generate a new one. Any MCP server configured with the old token will stop working until you update it with the new value.

My client doesn't show the Perfect Wiki tools. What's wrong?

Most common causes: the client wasn't restarted after editing the config, the Authorization header is missing or malformed (it must be Bearer your-api-token), the token was revoked, or the transport type in the config doesn't match http. Check your client's MCP logs for the exact error.

Can I use the server with LLMs other than Claude?

Yes. Any MCP-compatible client works — Cursor, Windsurf, Zed, custom agents built on the MCP spec, etc. The server is model-agnostic.

Is there a request quota or rate limit?

The MCP server is backed by the Perfect Wiki API, so the same quotas and rate limits as your plan's API apply. Heavy usage (e.g. bulk list_pages loops) can hit those limits — prefer the ask tool for broad questions over iterating every page.

Need help?

If something doesn't work as expected, contact support.