Documentero
List Documentero templates, inspect field schemas, and generate Word/PDF/Excel documents.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@documentero/mcpclaude mcp add documentero -e 'DOCUMENTERO_API_KEY=<your documentero_api_key>' -e 'DOCUMENTERO_BASE_URL=<DOCUMENTERO_BASE_URL>' -- npx -y @documentero/mcp@0.1.2
{
"mcpServers": {
"documentero": {
"command": "npx",
"args": [
"-y",
"@documentero/mcp@0.1.2"
],
"env": {
"DOCUMENTERO_API_KEY": "<your documentero_api_key>",
"DOCUMENTERO_BASE_URL": "<DOCUMENTERO_BASE_URL>"
}
}
}
}
متغيرات البيئة
DOCUMENTERO_API_KEYإلزامي سري Company API key from Documentero Account settingsDOCUMENTERO_BASE_URLOptional Cloud API base URL (default: https://app.documentero.com/api)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
@documentero/mcp
Official MCP server for Documentero — list templates, inspect field schemas, and generate Word/PDF/Excel documents from AI agents (Cursor, Claude Desktop, and more).
- npm:
@documentero/mcp - Source: github.com/documentero/documentero-mcp
- Website: documentero.com
- Docs: docs.documentero.com
Tools
| Tool | Description | |
|---|---|---|
list_templates | Templates with kind (word\ | excel), defaultFormat, allowedFormats |
get_template_fields | JSON Schema (primary, enriched value rules) + field definitions + allowed formats | |
generate_document | Generate Word/PDF or Excel document for given template and fields; signed URL (~1h) by default, or base64 if embed: true. format optional (template default). |
Setup
- Copy your API key from Documentero → Account settings.
- Add the MCP server to your client config.
Cursor / Claude Desktop (npx)
{
"mcpServers": {
"documentero": {
"command": "npx",
"args": ["-y", "@documentero/mcp"],
"env": {
"DOCUMENTERO_API_KEY": "your-api-key"
}
}
}
}
Local development
git clone https://github.com/documentero/documentero-mcp.git
cd documentero-mcp
npm install
npm run build
{
"mcpServers": {
"documentero": {
"command": "node",
"args": ["/absolute/path/to/documentero-mcp/dist/index.js"],
"env": {
"DOCUMENTERO_API_KEY": "your-api-key",
"DOCUMENTERO_BASE_URL": "https://app.documentero.com/api"
}
}
}
}
Use https://documentero-dev.web.app/api for the development environment.
Environment
| Variable | Required | Default | Description |
|---|---|---|---|
DOCUMENTERO_API_KEY | yes | — | Company API key (Account settings) |
DOCUMENTERO_BASE_URL | no | https://app.documentero.com/api | Cloud API base URL |
Typical agent flow
list_templates→ pick atemplateId(respectkind/allowedFormats)get_template_fields→ shapedatafromjsonSchema(usefieldDefinitionsfor extra context like HTML/Markdown/image/link/QR rules)generate_document→ download URL (or embedded base64)
Smoke test
npm run build
DOCUMENTERO_API_KEY=your-key npm run smoke
Notes
- Thin client of the public Cloud API (
/api/templates,/api/meta,/api/generate). Quotas and rate limits are enforced by Documentero as usual. - Do not put the API key in tool arguments — keep it in MCP env only.
- Word templates support output format:
docx/pdf; Excel templates support output format:xlsxonly. - Remote Streamable HTTP hosting (
https://mcp.documentero.com/mcp) is planned; this release is stdio only.
License
MIT © Documentero
الأسئلة الشائعة
ما هو Documentero؟
List Documentero templates, inspect field schemas, and generate Word/PDF/Excel documents.
كيف أثبّت Documentero؟
يعمل على جهازك. في Claude Code: claude mcp add documentero -e 'DOCUMENTERO_API_KEY=<your documentero_api_key>' -e 'DOCUMENTERO_BASE_URL=<DOCUMENTERO_BASE_URL>' -- npx -y @documentero/mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Documentero إلى مفتاح API؟
نعم. يتطلب DOCUMENTERO_API_KEY، وتضبطها في إعداداته.
هل Documentero مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Documentero؟
ينشره documentero. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.