Skip to main content
Connect Claude to Doconda so it can convert, create and edit Word, PowerPoint, Excel and PDF files. In the Claude apps and Claude Code it uses the MCP server; with the Claude API, the SDK tools or the API’s MCP connector.

Capabilities

  • Create a Word, PowerPoint, Excel or PDF file, or an artifact, from a request or from Markdown Claude wrote.
  • Edit a file: only what is asked changes, and get_report lists every change.
  • Convert a file to another format with no AI, for example any file to Markdown so Claude can read it.
  • Read what people saved in an artifact, such as poll votes.

Setup

The Claude connector signs you in with your Doconda account. Everything else uses a Doconda API key (ak_eu_…, from API keys); the Claude API also needs your Anthropic key in ANTHROPIC_API_KEY.

Claude connector (web, desktop and mobile)

  1. In Claude, go to Customize → Connectors → Add custom connector.
  2. Enter https://api.eu.doconda.com/mcp.
  3. When Claude opens Doconda, sign in, choose the organization and project it works in (and whether it may only read) and approve.
The connector works the same on the web, in the desktop app and on mobile. Disconnect it in the Doconda dashboard under Connected apps. Claude’s connector stops waiting for a tool call after about a minute, and a document at standard takes a few minutes. So with this connector create_document and edit_document return after about 50 s: a document still being made comes back with its id and status, and Claude calls get_document later for the result and its links. If Claude says a document is still being made, ask it to check on it, not to make it again: each new request is a new document, billed again.

Claude Desktop (local server)

Open the configuration file (Settings → Developer → Edit Config):
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude and ask, for example: “Make me a lease agreement for €900 a month in Word, with blue headings”. The server runs on your computer, so Claude can also convert or edit your own files by their full path: “Add a confidentiality clause to /Users/ana/Documents/contract.docx”.

Claude Code

The local server, with an API key:
The remote server, signing in with your Doconda account (run /mcp in Claude Code to connect it):
The remote server with an API key instead of signing in:
Add --scope user to have it in all your projects.

Claude API

With Python

With TypeScript

The tools from doconda.tools() have the shape the Anthropic SDK’s tool runner expects:

With the MCP connector

With the API’s MCP connector (in beta), Claude calls Doconda’s remote server without you running anything:
Claude’s final answer includes the document’s download links. File links expire after 5 minutes.

Tools

Claude gets the eight Doconda tools; see the tools for what each one does. With the SDK, doconda.tools() returns them with name, description, a JSON Schema (inputSchema in TypeScript, input_schema in Python) and run. A failed call returns { "error": "<code>", "message": "…" } instead of raising, so Claude can correct itself.

Troubleshooting

  • Doconda: pass { apiKey } or set DOCONDA_API_KEY. — The SDK found no key (in Python: Doconda: pass api_key or set DOCONDA_API_KEY.). Set DOCONDA_API_KEY, or pass the key to Doconda.
  • Claude Desktop doesn’t list the tools — Restart Claude after editing the configuration file, and check that Node.js 22 or later is installed (the server runs with npx).
  • A tool result has "error": "insufficient_balance" — The project’s balance can’t cover the document: top up in the dashboard, or ask for quality: "fast".
  • The download link stopped working — File links expire after 5 minutes; Claude calls get_document for fresh ones.