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

> Doconda para cualquier cliente MCP, en tu ordenador o remoto.

El servidor MCP de Doconda da a tu agente las [herramientas](/agents/introduction#las-herramientas) para crear,
revisar y editar documentos. Hay dos formas de usarlo:

| | Local | Remoto |
| - | - | - |
| Qué es | `npx -y @doconda/mcp`, en tu ordenador (stdio) | `https://api.eu.doconda.com/mcp` (Streamable HTTP) |
| Autenticación | Variable `DOCONDA_API_KEY` | Cabecera `Authorization: Bearer ak_…` |
| Puede leer ficheros de tu disco | Sí (`upload_file` con `path`) | No: se suben por URL o en base64 |
| Para | Claude Desktop, Claude Code, Cursor, Codex, scripts | n8n, Le Chat, agentes alojados en la nube |

<Note>Para proyectos de EE. UU., el remoto es `https://api.us.doconda.com/mcp` (con una key `ak_us_…`).</Note>

## Local

Cualquier cliente que lance servidores por stdio. La configuración típica:

```json theme={null}
{
  "mcpServers": {
    "doconda": {
      "command": "npx",
      "args": ["-y", "@doconda/mcp"],
      "env": { "DOCONDA_API_KEY": "ak_eu_…" }
    }
  }
}
```

## Remoto

Cualquier cliente con transporte Streamable HTTP:

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

## Clientes concretos

<CardGroup cols={2}>
  <Card title="Claude Desktop y Claude Code" href="/agents/claude" />

  <Card title="Cursor" href="#cursor" />

  <Card title="OpenAI Codex" href="#openai-codex" />

  <Card title="LangChain" href="/agents/langchain" />

  <Card title="CrewAI" href="/agents/crewai" />

  <Card title="n8n" href="/agents/n8n" />

  <Card title="Hugging Face (smolagents)" href="/agents/hugging-face" />
</CardGroup>

### Cursor

En `.cursor/mcp.json` (este proyecto) o `~/.cursor/mcp.json` (todos):

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

O el remoto: `"doconda": { "url": "https://api.eu.doconda.com/mcp", "headers": { "Authorization": "Bearer ${env:DOCONDA_API_KEY}" } }`.

### OpenAI Codex

En `~/.codex/config.toml` (lo usan la CLI y la extensión del editor):

```toml theme={null}
[mcp_servers.doconda]
command = "npx"
args = ["-y", "@doconda/mcp"]
env = { DOCONDA_API_KEY = "ak_eu_…" }
```

## Tu propio servidor

Si ya tienes un servidor MCP, añade las herramientas de Doconda: son JSON Schema, así que valen tal cual.

```ts theme={null}
import { Doconda } from "@doconda/sdk"
import { createServer } from "@doconda/mcp"

const server = createServer(new Doconda()) // un Server del SDK oficial de MCP, listo para conectar a tu transporte
```


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