Tiptap Collaboration MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
get-server-statisticsGet server-wide usage statistics.
get-document-statisticsGet real-time statistics for a specific document.
id (string): Document IDHEAD request (available since server 3.91.0). On older servers the check is skipped and a missing document reports zeroes.create-documentCreate a new collaborative document.
name (string): Name of the documentcontent (object, optional): Initial content in Tiptap JSON format; defaults to {"type": "doc", "content": [{"type": "paragraph"}]}get-documentRetrieve a collaborative document.
id (string): ID of the document to retrievelist-documentsList all available collaborative documents.
update-documentUpdate a collaborative document with new content.
id (string): Document IDcontent (object): Document content in Tiptap JSON formatmode (string, optional): Update mode - "replace" or "append" (default: "replace")delete-documentDelete a collaborative document.
id (string): ID of the document to deleteduplicate-documentDuplicate an existing collaborative document (fetches the source as JSON and creates the target from it; versions are not copied).
sourceId (string): ID of the source document to duplicatetargetId (string): ID for the new duplicated documentsearch-documentsSearch documents using semantic search.
query (string): Search querylimit (number, optional): Maximum results, 1-100 (default: 10)These two tools call the Tiptap Conversion service (https://api.tiptap.dev by default), not the collaboration server. They require CONVERT_TOKEN (a Tiptap Cloud Convert JWT); without it they return setup guidance instead of making a request.
import-markdownConvert Markdown content to Tiptap JSON format.
content (string): Markdown content to convertappId (string, optional): Tiptap Convert App IDformat (string, optional): Accepted for backwards compatibility; the v2 Conversion API has no format switchexport-markdownConvert Tiptap JSON content to Markdown format.
content (object): Tiptap JSON content to convertappId (string, optional): Tiptap Convert App IDformat (string, optional): Accepted for backwards compatibility; the v2 Conversion API has no format switchgit clone <repository-url>
cd tiptap-collaboration-mcp
npm install
npm run build
Configuration is passed as command-line arguments only (a .env file is not read).
node /path/to/build/index.js BASE_URL <url> API_TOKEN <token> [CONVERT_TOKEN <jwt>] [CONVERT_URL <url>]
Add this server to your Claude, Windsurf, or any other host with the relevant syntax. An example:
"tiptap-collaboration": {
"command": "node",
"args": [
"/path/to/tiptap-collaboration-mcp/build/index.js",
"BASE_URL",
"http://localhost:8080",
"API_TOKEN",
"your-actual-api-token"
]
}
npm run dev -- BASE_URL <url> API_TOKEN <token> # run from source (tsx)
npm run inspect -- BASE_URL <url> API_TOKEN <token> # MCP Inspector
npm run typecheck # type-check src + tests
npm run format # prettier
npm test # unit tests (mocked fetch)
npm run test:live # integration tests against a real server
The live suite is skipped unless pointed at a server:
TIPTAP_TEST_BASE_URL=http://localhost:8080 \
TIPTAP_TEST_API_TOKEN=<your API secret> \
npm run test:live
Set TIPTAP_TEST_CONVERT_TOKEN as well to exercise the conversion tools for real; without it they are asserted to return their setup guidance. The suite creates uniquely named mcp-live-* documents and deletes them afterwards.
search-documents) only works against Tiptap Cloud servers with the restricted-beta Semantic Search feature enabled — it is not part of the self-hosted collaboration server image.CONVERT_TOKEN); the conversion service is separate from the collaboration server.X-Correlation-Id (e.g. [HTTP 404, correlation-id …]) so failures can be matched against collaboration server logs.This project is licensed under the MIT License - see the LICENSE file for details.
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Tiptap Collaboration 通过 stdio 在本地运行。
上次检查时间:2026-10-27。 A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.