Connect your Perfect Wiki knowledgebase to Claude, ChatGPT, Microsoft 365 Copilot and other MCP-compatible AI assistants via the Perfect Wiki MCP server. Once connected, your assistant can read, search, create and update pages in your knowledgebase directly from the chat.
The MCP server endpoint is:
https://api.perfectwiki.xyz/mcpHow authentication works
You connect by signing in with your Perfect Wiki account (OAuth). During the connection you choose which knowledgebases to expose and which permissions to grant โ read-only or read & write. There are no tokens to copy, and you can revoke access at any time.
Microsoft 365 Copilot
Perfect Wiki is available in Microsoft 365 Copilot as a ready-made agent, with the same tools and sign-in โ no MCP setup needed. Open Perfect Wiki in Copilot ยท details: Microsoft 365 Copilot Integration
Claude (web, desktop and mobile)
- In Claude, open Customize โ Connectors
Open the Perfect Wiki connector via the link or find Perfect Wiki and click the + button to connect to Claude

Choose your rights - Read only or Read & Write and the knowledge bases access - all or a selected one

- Click Allow Access
When quering Perfect Wiki for the first time, you'll need to Allow the Access to your content

- After that you can read, update and query your Perfect Wiki content through Claude
ChatGPT (Developer Mode)

- In ChatGPT, enable connector support: Settings โ Connectors โ Advanced โ Developer mode.
- Add a new connector with the server URL https://api.perfectwiki.xyz/mcp and choose OAuth as the authentication method.
- ChatGPT opens the Perfect Wiki sign-in and consent screen โ pick your knowledgebases and approve access.
- Enable the connector in a conversation to use the tools.
Claude Code
claude mcp add --transport http -s user perfect-wiki https://api.perfectwiki.xyz/mcpThen run /mcp inside Claude Code and follow the browser sign-in to authorize the connection.
Tip: the -s (--scope) flag controls where the server configuration is stored:
- -s local (default) โ saved to the current project only.
- -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, so the whole team gets the same server.
Automation platforms (n8n, Make, Activepieces)
These platforms can call the MCP server from a workflow, using the endpoint above and Perfect Wiki sign-in:
- n8n: MCP Client Tool node in an AI Agent workflow, with Server Transport set to HTTP Streamable and Authentication set to MCP OAuth2 (n8n 1.119.0 or later). See ๐ n8n Integration.
- Make: MCP Client app, adding Perfect Wiki with + New MCP Server. Use Call a tool or Execute an action with AI. See ๐ Make Integration.
- Activepieces: MCP Client piece with the Call Tool action and an OAuth 2.0 connection (Activepieces 0.93.0 or later). See ๐ Activepieces Integration.
Each guide also covers the Public API route, which works in regular workflows without an AI step. Pipedream works through the Public API only: see ๐ Pipedream Integration.
Tools
Once connected, your assistant gets the following tools. They cover both reading and writing, so you can ask it to look something up and to draft or update a page for you โ for example: "Update the onboarding page with these three new steps."
- ask โ ask a natural-language question and get an answer with the related pages
- create_page โ create a new page
- delete_page โ delete a page
- get_knowledgebase โ get info about a connected knowledgebase
- get_page โ read the full content of a page
- list_knowledgebases โ list the knowledgebases the connection can use, with their access level
- list_pages โ list all pages in a knowledgebase
- prepare_file_upload โ get a one-use link to upload a file from your computer (screenshot, image, PDF or any other file) to a page
- update_page โ update an existing page: title, content, tags or parent page
- upload_file_from_url โ add an image or file from a public link to a page
Writing tools (create_page, update_page, delete_page, prepare_file_upload, upload_file_from_url) are only available if you granted Read & Write access when connecting.
Adding images and files
Your assistant can add screenshots, images, PDFs and any other files to a page, up to 30 MB per file, just like the editor. Images show inline, other files appear as an attachment with a Download button.
- Files on your computer: in Claude Code, Cursor and other assistants that can run commands, ask for example "Add ./screenshots/login.png to the Onboarding page under step 2." The assistant calls prepare_file_upload and uploads the file with the command it gets back.
- Files from a link: in any assistant, ask for example "Add the diagram from https://example.com/architecture.png to the Architecture page." The assistant calls upload_file_from_url. The link must be publicly reachable.
Images pasted into a chat (Claude or ChatGPT on the web, desktop or mobile) can't be added this way yet: the assistant sees the image but can't pass the file on to Perfect Wiki. Share a link to the image instead, or save it as a file and use Claude Code.
Adding files needs Read & Write access. Each organization can add up to 60 files an hour and 300 a day.
Permissions and knowledgebase selection
On the consent screen you grant permissions:
- wiki:read โ list pages, read page content, and ask AI-powered questions
- wiki:write โ create, update and delete pages, and add images and files to them
You also choose which knowledgebases the connection can reach โ all of them, or a selected one. If the connection covers several knowledgebases, tools take a knowledgebase_id so your assistant knows which one to work in; with a single knowledgebase it can be omitted.
Verifying the connection
Once configured, your client should list the Perfect Wiki tools above. Try asking your assistant: "List the pages in my Perfect Wiki knowledgebase."
FAQ
Can one connection access multiple knowledgebases?
Yes. On the consent screen you can grant access to all your knowledgebases or to a single selected one. When several are available, ask your assistant to work in one by name and it will pick the matching knowledgebase.
Can the assistant delete or overwrite my pages?
Only if the connection has write access, which requires the wiki:write permission granted on the consent screen โ connect with read-only permissions if you want a safe setup. Most MCP clients additionally ask for your confirmation before running a write tool.
How do I revoke access?
Remove the connector in your assistant's settings โ its access stops working shortly after.
The assistant says a tool needs a permission it doesn't have. What's wrong?
The connection was approved with fewer permissions (e.g. read-only). Remove the connector and reconnect, granting wiki:write on the consent screen.
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.
Can the assistant search files synced from SharePoint and page attachments?
Yes. The ask tool searches the same index as the Perfect Wiki AI Agent, and that index includes files synced from SharePoint folders and files attached to pages, as long as they've been indexed. Matching files appear in the answer's related results, with a link to open the file in Perfect Wiki.
- list_pages and get_page only work with wiki pages, so the assistant can't open a file by itself. It sees only the parts of the file that matched the question. We plan to add list_files and get_file tools so the assistant can list a knowledgebase's files and read a whole file.
- Attachments are indexed only when indexing is on: Knowledge Base Settings โ Attachments. See Search across Attachments and Images.
- SharePoint files show up after the folder has synced, which happens automatically every 24 hours or with Sync Now. See SharePoint Synchronization.
- Your plan limits how many files are indexed. Files over the limit aren't searchable, either in Perfect Wiki or through MCP.
I don't see the tools for adding images and files.
Assistants load the list of tools when they connect. Start a new chat; if prepare_file_upload and upload_file_from_url still don't appear, remove the connector and add it again.
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 connection wasn't completed (finish the sign-in and consent flow), access was revoked, or the transport type in the config doesn't match http. Check your client's MCP logs for the exact error.
Why can't I connect? I'm getting a 402 error.
A 402 error with the code TRIAL_EXPIRED means your Perfect Wiki free trial has ended. MCP access is paused for your whole organization, including read-only tools, until it moves to a paid plan. Ask an admin to choose a plan on the Billing page in Perfect Wiki. Your assistant can use Perfect Wiki again as soon as the plan is active; you don't need to remove and re-add the connector.
Can I use the server with LLMs other than Claude and ChatGPT?
Yes. Any MCP-compatible client works โ Cursor, Windsurf, Zed, VS Code (Copilot agent mode), 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.
Why aren't reading functionalities listed among the Claude capabilities?
Our MCP server sends the same list of 10 tools to every connection, regardless of whether you choose "Read only" or "Read & write" on the consent screen: list_knowledgebases, get_knowledgebase, list_pages, get_page, create_page, update_page, delete_page, prepare_file_upload, upload_file_from_url and ask. We verified this against production โ the access level you pick changes what the tools are allowed to do, never which tools Claude is shown. So the read tools are definitely being sent to Claude in your case too.
Why aren't reading features working on Claude?
That can happen if the organization settings for the connector are turned off by default. Admins can manage the settings via Claude directory.
_6d3c8648-a41d-435a-95f8-0019f2a3955b.png)
Need help?
If something doesn't work as expected, contact support.