> ## 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.

# Cómo dar a un agente herramientas de documentos con MCP

> Conecta tu cliente MCP a https://api.eu.doconda.com/mcp con tu API key: el agente crea, revisa y edita Word, PowerPoint, Excel y PDF.

Conecta cualquier cliente MCP con transporte Streamable HTTP a `https://api.eu.doconda.com/mcp`, con la cabecera
`Authorization: Bearer` y tu API key. El agente recibe las herramientas de Doconda (`create_document`,
`review_document`, `edit_document`…) y cada llamada devuelve el estado del documento y sus enlaces de descarga.

## Pasos

1. Crea una API key en el panel, en **API keys** (empieza por `ak_eu_`), y guárdala en `DOCONDA_API_KEY`.

2. Apunta tu cliente al servidor remoto:

   ```
   URL:       https://api.eu.doconda.com/mcp
   Cabecera:  Authorization: Bearer ak_eu_…
   ```

3. Si tu cliente pone un tiempo máximo por llamada, súbelo: un documento tarda más en estar listo que una llamada normal.

Por ejemplo, desde código, con el OpenAI Agents SDK o con el AI SDK de Vercel:

<CodeGroup>
  ```python Python 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())
  ```

  ```ts TypeScript theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  // npm install ai @ai-sdk/anthropic @ai-sdk/mcp
  import { anthropic } from "@ai-sdk/anthropic"
  import { createMCPClient } from "@ai-sdk/mcp"
  import { generateText, isStepCount } from "ai"

  const doconda = await createMCPClient({
    transport: {
      type: "http",
      url: "https://api.eu.doconda.com/mcp",
      headers: { Authorization: `Bearer ${process.env.DOCONDA_API_KEY}` },
    },
  })

  const { text } = await generateText({
    model: anthropic("claude-sonnet-5-5"),
    tools: await doconda.tools(),
    stopWhen: isStepCount(5),
    prompt: "Hazme un Excel con el presupuesto del evento",
  })
  console.log(text)
  await doconda.close()
  ```
</CodeGroup>

En Claude Code es una línea:
`claude mcp add --transport http doconda https://api.eu.doconda.com/mcp --header "Authorization: Bearer ak_eu_…"`.

## 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 (por URL o en base64 en el remoto). |
| `review_document` · `edit_document` | Revisa y arregla, o 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. |

Cada herramienta devuelve un resumen corto (`id`, `format`, `status`, `links`) para que el agente se lo cuente al usuario
sin gastar contexto. Los errores también 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`, stdio) puede
    subir ficheros de tu ordenador; es para Claude Desktop, Cursor o Codex.
  </Accordion>

  <Accordion title="¿Qué clientes funcionan?">
    Cualquiera con Streamable HTTP: Claude, Cursor, LangChain, CrewAI, Google ADK, OpenAI Agents SDK, Mastra, n8n,
    smolagents, Le Chat…
  </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 y clientes concretos.
* [Quickstart](/quickstart).


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