# Base de Conhecimento — how to use (mcp.ai)

Your private knowledge base: upload documents (.md, .txt, .docx, PDF, images), the platform indexes everything semantically and the agent retrieves the relevant context on demand. Built for firms. Each base is isolated, content stays encrypted on the platform. You pay only for what you store.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kb?ms=1785595200000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kb_add_text`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kb`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kb/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kb/add/text` — Adiciona um texto colado à base (vira um documento indexado e buscável). Útil pra notas, trechos, anotações.
  - body: { title: string, text: string, account?: string }
- `POST https://api.mcp.ai/api/kb/get/document` — Metadados + status de um documento específico (sem o texto cru).
  - body: { document_id: string, account?: string, document_ids?: string[] }
- `POST https://api.mcp.ai/api/kb/ingest/url` — Baixa um arquivo de uma URL (.md/.txt/.docx) e o indexa na base. Bom pra ingerir um documento remoto sem upload manual.
  - body: { url: string, filename?: string, account?: string }
- `POST https://api.mcp.ai/api/kb/list/accounts` — Lista as bases de conhecimento conectadas neste install. Retorna cada base com id, rótulo e um flag is_default (true quando só há uma — não precisa passar `account` nas outras tools). Com várias bases
- `POST https://api.mcp.ai/api/kb/list/documents` — Lista os documentos da base (id, nome, status, tamanho, nº de chunks).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/kb/remove/document` — Remove um ou mais documentos da base (apaga o original, os chunks e o índice). Aceita uma lista de ids.
  - body: { document_ids: string[], account?: string }
- `POST https://api.mcp.ai/api/kb/search` — Busca semântica na base de conhecimento. Devolve os trechos (chunks) mais relevantes pra usar como contexto, com nome do arquivo de origem e score. Retrieval-only: você sintetiza a resposta a partir d
  - body: { query: string, top_k?: integer, account?: string }

## Example prompts
- "Search my base: what's the termination notice in the standard contract?"
- "Add this note to the knowledge base"
- "List the documents in my base"

## More
- Page: https://mcp.ai/kb
- Agent spec (llms.txt): https://mcp.ai/kb/llms.txt
- Postman collection: https://mcp.ai/kb/postman.json