Tiptap Collaboration MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
Усильте агента
Установка от издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
В реестре пока нет пакетного релиза. Следуйте README репозитория.
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя
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.
Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Tiptap Collaboration работает локально через stdio.
Последняя проверка: 2026-10-27. A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.