> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doconda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP para Word, Excel y PowerPoint

> Un servidor MCP para Word, Excel y PowerPoint: remoto en https://api.eu.doconda.com/mcp o local con npx -y @doconda/mcp, para Claude, Cursor o tu agente.

El servidor MCP para Word, Excel y PowerPoint de Doconda da a tu agente herramientas para crear, revisar y editar
archivos `.docx`, `.xlsx`, `.pptx` y PDF editables. Úsalo remoto en `https://api.eu.doconda.com/mcp` con la cabecera
`Authorization: Bearer` y tu API key, o local con `npx -y @doconda/mcp`.

## Pasos

1. Crea una API key en el panel, en **API keys** (empieza por `ak_eu_`).

2. Elige cómo conectarte:

   | | Local | Remoto |
   | - | - | - |
   | Qué es | `npx -y @doconda/mcp` (stdio) | `https://api.eu.doconda.com/mcp` (Streamable HTTP) |
   | Autenticación | Variable `DOCONDA_API_KEY` | Cabecera `Authorization: Bearer ak_eu_…` |
   | Lee ficheros de tu disco | Sí | No: se suben por URL o en base64 |

3. Añádelo a tu cliente:

<CodeGroup>
  ```json Claude Desktop theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "mcpServers": {
      "doconda": {
        "command": "npx",
        "args": ["-y", "@doconda/mcp"],
        "env": { "DOCONDA_API_KEY": "ak_eu_…" }
      }
    }
  }
  ```

  ```bash Claude Code theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  claude mcp add --transport stdio doconda --env DOCONDA_API_KEY=ak_eu_… -- npx -y @doconda/mcp

  # o el servidor remoto
  claude mcp add --transport http doconda https://api.eu.doconda.com/mcp --header "Authorization: Bearer ak_eu_…"
  ```

  ```json Cursor theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "mcpServers": {
      "doconda": {
        "command": "npx",
        "args": ["-y", "@doconda/mcp"],
        "env": { "DOCONDA_API_KEY": "${env:DOCONDA_API_KEY}" }
      }
    }
  }
  ```

  ```python OpenAI Agents SDK theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  # pip install openai-agents
  import asyncio
  import os

  from agents import Agent, Runner
  from agents.mcp import MCPServerStreamableHttp


  async def main():
      async with MCPServerStreamableHttp(
          name="doconda",
          params={
              "url": "https://api.eu.doconda.com/mcp",
              "headers": {"Authorization": f"Bearer {os.environ['DOCONDA_API_KEY']}"},
          },
          client_session_timeout_seconds=300,
      ) as doconda:
          agent = Agent(name="Documentos", model="gpt-5", mcp_servers=[doconda])
          result = await Runner.run(agent, "Hazme un Excel con el presupuesto del evento")
          print(result.final_output)


  asyncio.run(main())
  ```
</CodeGroup>

En Claude Desktop, el fichero está en **Ajustes → Desarrollador → Editar configuración**. En Cursor, en
`.cursor/mcp.json` (este proyecto) o `~/.cursor/mcp.json` (todos); el remoto en Cursor es
`"doconda": { "url": "https://api.eu.doconda.com/mcp", "headers": { "Authorization": "Bearer ${env:DOCONDA_API_KEY}" } }`.
Si tu cliente pone un tiempo máximo por llamada, súbelo: un documento tarda más que una llamada normal.

## Qué devuelve

| Herramienta | Qué hace |
| - | - |
| `create_document` | Crea un Word, PDF, PowerPoint, Excel o artifact, con una frase o con el contenido ya escrito. |
| `upload_file` | Sube un fichero (en el local, también desde tu disco). |
| `review_document` | Revisa un archivo y arregla los problemas seguros. |
| `edit_document` | Cambia lo que se pida sin tocar lo demás. |
| `list_documents` · `get_document` · `get_report` | Documentos del proyecto, estado y enlaces nuevos, informe. |
| `read_artifact_data` | Lo que la gente ha guardado en un artifact. |

La lista de herramientas se puede ver sin key; para usarlas hace falta la API key. Cada herramienta devuelve un resumen
corto (`id`, `format`, `status`, `links`), y los errores llegan como resultado, con un código que el agente puede
corregir.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Remoto o local?">
    El remoto sirve para agentes en la nube y n8n, y no lee tu disco. El local (`npx -y @doconda/mcp`) puede subir
    ficheros de tu ordenador: es para Claude Desktop, Claude Code, Cursor o Codex.
  </Accordion>

  <Accordion title="¿Puedo editar un Word que ya tengo?">
    Sí. Con el local, pídeselo con la ruta completa (*"Revisa /Users/ana/Documentos/contrato.docx"*). Con el remoto,
    el fichero se sube por URL o en base64 y luego se usa `edit_document` o `review_document`.
  </Accordion>

  <Accordion title="¿En qué idioma llegan los mensajes?">
    En inglés. El remoto sigue `Accept-Language`: envía `Accept-Language: es` para tenerlos en español.
  </Accordion>

  <Accordion title="¿Cuánto cuesta?">
    Lo que hace el agente cuenta como si lo hicieras tú con la API: mismo proyecto, mismo precio. Ver
    [precios](/guides/account#precios).
  </Accordion>
</AccordionGroup>

## Sigue leyendo

* [Servidor MCP](/agents/mcp): local, remoto, Codex y tu propio servidor.
* [Claude](/agents/claude): Claude Desktop, Claude Code y la API de Claude.
* [Quickstart](/quickstart).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.