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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# MCP

> Collega Claude, Cursor o qualsiasi client MCP al server MCP di Conare, così il tuo agente può cercare, recuperare, salvare ed eliminare documenti.

Conare è un server MCP all'indirizzo `https://api.conare.ai/mcp`: il tuo agente può cercare, leggere, salvare ed eliminare documenti in ogni namespace raggiungibile dalla tua chiave.

```bash Claude Code theme={null}
claude mcp add --transport http conare https://api.conare.ai/mcp \
  --header "Authorization: Bearer $CONARE_API_KEY"
```

```json Cursor (~/.cursor/mcp.json) theme={null}
{
  "mcpServers": {
    "conare": {
      "url": "https://api.conare.ai/mcp",
      "headers": { "Authorization": "Bearer sk-conare-..." }
    }
  }
}
```

Un client che supporta OAuth, come un connettore personalizzato di Claude, richiede solo l'URL: ti fa accedere a Conare nel browser.

## Agenti di coding

Dai a Claude Code, Cursor o Codex lo skill di Conare, così scrive codice Conare corretto:

```bash theme={null}
npx skills add https://docs.conare.ai
```

Per far cercare a un agente in questa documentazione, aggiungi `https://docs.conare.ai/mcp` come server MCP.

## Strumenti

| Strumento | Cosa fa |
| - | - |
| `search` | Cerca in un namespace, in più namespace o in tutti, e risponde dai 20 documenti migliori, dopo il reranking |
| `fetch` | Legge un documento per namespace e id, 40.000 caratteri alla volta (`max_chars` fino a 80.000) |
| `save` | Scrive un documento; il namespace predefinito è `notes` |
| `delete` | Elimina un documento per namespace e id |
| `list_namespaces` | Elenca i tuoi namespace e quanti documenti contiene ciascuno |

## Opzioni di `search`

| Opzione | Cosa fa |
| - | - |
| `query` | La domanda, come frase descrittiva |
| `namespace` | Un namespace in cui cercare; omettilo per cercare in tutti, fino a 100 |
| `namespaces` | Da 1 a 100 namespace, classificati insieme |
| `filter` | Un [filtro sui metadati](https://docs.conare.ai/it/filters.md) |
| `user`, `user_prefix` | Solo i documenti di un [utente](https://docs.conare.ai/it/write.md#utenti), o di un gruppo |
| `answer` | `true` (predefinito) scrive una risposta; `false` restituisce i passaggi |

Una [chiave](https://docs.conare.ai/it/console.md#chiavi) **Models only** non può usare MCP.


## Related topics

- [Guida rapida](https://docs.conare.ai/it/quickstart.md)
- [Introduzione](https://docs.conare.ai/it/index.md)


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