> For the complete documentation index, see [llms.txt](https://docs-it.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-it.docbits.com/advanced-functions-and-tools/docflow-mcp/setup-and-configuration.md).

# Installazione e Configurazione

## Endpoint API

| Ambiente   | Endpoint MCP                             |
| ---------- | ---------------------------------------- |
| Sviluppo   | `https://dev.api.docbits.com/api/mcp/`   |
| Stage      | `https://stage.api.docbits.com/api/mcp/` |
| Produzione | `https://api.docbits.com/api/mcp/`       |

## Autenticazione

Tutte le richieste MCP richiedono una chiave API DocBits valida passata come token Bearer. Puoi trovare la tua chiave API in **Impostazioni > Integrazione** nell'interfaccia DocBits.

Il token viene inviato tramite l'header `Authorization`:

```
Authorization: Bearer <your-api-key>
```

{% hint style="warning" %}
Gli strumenti riservati agli admin (`sdk_approve_card`, `sdk_reject_card`, `sdk_delete_submission`) richiedono un token di amministratore dell'organizzazione.
{% endhint %}

## Configurazione del Client

### Claude Code

Aggiungi il server MCP DocFlow utilizzando la CLI:

```bash
claude mcp add docflow-dev \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -- https://dev.api.docbits.com/api/mcp/
```

Oppure aggiungilo al file di configurazione `.claude.json`:

```json
{
  "mcpServers": {
    "docflow-dev": {
      "type": "http",
      "url": "https://dev.api.docbits.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Puoi anche aggiungerlo a un file `.mcp.json` a livello di progetto:

```json
{
  "mcpServers": {
    "docflow-dev": {
      "type": "http",
      "url": "https://dev.api.docbits.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Claude Desktop

Aggiungi quanto segue al tuo `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "docflow": {
      "type": "streamable-http",
      "url": "https://dev.api.docbits.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

{% hint style="info" %}
Su macOS, il file di configurazione si trova in `~/Library/Application Support/Claude/claude_desktop_config.json`. Su Windows: `%APPDATA%\Claude\claude_desktop_config.json`.
{% endhint %}

### OpenAI Codex

Codex CLI supporta i server MCP. Aggiungi alla configurazione del tuo progetto:

```json
{
  "mcpServers": {
    "docflow": {
      "type": "http",
      "url": "https://dev.api.docbits.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Client MCP Generico (Python)

Per integrazioni personalizzate utilizzando l'SDK Python MCP:

```python
from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async def connect():
    async with streamablehttp_client(
        url="https://dev.api.docbits.com/api/mcp/",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
    ) as (read_stream, write_stream, _):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()
            tools = await session.list_tools()
            print(f"Available tools: {[t.name for t in tools.tools]}")
```

## Verifica della Connessione

Dopo aver configurato il client, testa la connessione chiamando lo strumento `list_workflows`. Non richiede parametri e dovrebbe restituire un array di workflow (o un array vuoto per le nuove organizzazioni).

{% hint style="info" %}
Se ricevi errori di autenticazione, verifica che la tua chiave API sia corretta e che l'header `Authorization` venga inviato. Alcuni client MCP richiedono un riavvio dopo la modifica della configurazione.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs-it.docbits.com/advanced-functions-and-tools/docflow-mcp/setup-and-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.