Come collegare 1C:Enterprise a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → 1C:Enterprise, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

1C:Enterprise + Gemini

Leggi la tua infobase 1C:Enterprise 8.3 (1С:Бухгалтерия, Управление торговлей, 1С:ERP, УНФ e altre configurazioni) tramite la sua interfaccia OData standard: anagrafiche, documenti con le loro sezioni tabellari, saldi, movimenti e valori alla data dei registri, con i nomi presi dai metadati della tua configurazione. Sola lettura, autenticazione Basic, il tuo server.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ONEC_BASE_URL, ONEC_USER, ONEC_PASSWORD

Step 1 — Ottieni le credenziali

La configurazione richiede circa 30 minuti e serve il tuo amministratore 1C. Ti serve una infobase 1C:Enterprise 8.3 (piattaforma 8.3.5 o successiva) pubblicata su un web server con l'interfaccia OData standard attiva, e un utente 1C dedicato al connettore.

1. Pubblica la infobase su un web server (Apache o IIS con i moduli di estensione web server della piattaforma). Nel Designer apri Администрирование → Публикация на веб-сервере (Administration → Publish to web server), dai alla pubblicazione un nome in caratteri latini, spunta Публиковать стандартный интерфейс OData (Publish standard OData interface) e pubblica. Se la tua infobase è presso un provider di hosting 1C (1cFresh, noleggio cloud), chiedi al provider di attivare OData.
2. Scegli cosa può mostrare OData. Di default l'interfaccia non espone alcun oggetto. Nelle configurazioni tipiche apri Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData (oppure Все функции → Обработки → Настройка стандартного интерфейса OData) e aggiungi le anagrafiche, i documenti e i registri che l'AI può leggere. Nelle altre configurazioni uno sviluppatore richiama УстановитьСоставСтандартногоИнтерфейсаOData().
3. Crea un utente 1C dedicato con ruoli di sola lettura su quegli oggetti e il diritto di usare l'interfaccia OData standard. Il modulo di impostazione del passo 2 può creare questo utente per te.
4. Verifica nel browser: apri l'indirizzo della pubblicazione seguito da /odata/standard.odata/?$format=json e accedi con quell'utente. Un elenco JSON di oggetti significa che OData funziona; un elenco vuoto significa che manca il passo 2.
5. Inserisci l'indirizzo della pubblicazione in ONEC_BASE_URL: quello con cui apri il web client, senza /odata e senza barra finale, per esempio https://1c.example.com/trade. In ONEC_USER metti il nome utente esattamente come nell'elenco utenti della infobase (i nomi in cirillico funzionano) e in ONEC_PASSWORD la sua password.
6. Installa il connettore ed esegui onec_enterprise_describe_service: elenca ogni oggetto pubblicato su OData con le sue chiavi. Un elenco vuoto significa che alla composizione OData non è stato ancora aggiunto nulla.

Il server deve essere raggiungibile: AnythingMCP Cloud raggiunge solo indirizzi su internet pubblico, quindi pubblica in HTTPS su un host pubblico; la password viaggia con l'autenticazione HTTP Basic. Se il server 1C è nella tua rete interna, installa AnythingMCP in self-hosting lì (o collegalo via VPN) e aggiungi l'host a SSRF_ALLOWED_HOSTS.

Cosa legge: anagrafiche, documenti con le loro sezioni tabellari, registri informativi, di accumulo e contabili, piani dei conti, costanti e giornali dei documenti, con i nomi presi dai metadati della tua configurazione, di solito in russo: Catalog_Номенклатура, Document_РеализацияТоваровУслуг con le righe in Document_РеализацияТоваровУслуг_Товары, AccumulationRegister_ТоварыНаСкладах, AccountingRegister_Хозрасчетный. Funziona con ogni configurazione della piattaforma: 1С:Бухгалтерия предприятия, Управление торговлей, 1С:ERP, Комплексная автоматизация, УНФ, Розница, ЗУП e quelle personalizzate.

Saldi, movimenti e valori alla data: per i registri l'AI legge le tabelle virtuali Balance, Turnovers, BalanceAndTurnovers, SliceLast e SliceFirst con onec_enterprise_get, così è 1C a filtrare e aggregare sul server invece dell'AI che somma migliaia di righe. In questo modo risponde su giacenze a una data, vendite di un periodo, ultimo tasso di cambio o saldo del conto 62.01.

Come lavora l'AI: onec_enterprise_guide spiega nomi, filtri e registri senza costi. onec_enterprise_describe_entity mostra i campi di un oggetto e i loro tipi, onec_enterprise_query legge elenchi con filtro, ordinamento, scelta dei campi e paginazione, e onec_enterprise_get_entity legge un oggetto tramite Ref_Key insieme alle sue sezioni tabellari. I campi di riferimento come Контрагент_Key contengono un GUID; l'AI recupera il nome invece di mostrarti GUID.

Totali puliti: l'AI conta solo i documenti registrati (Posted eq true) e lascia fuori gli oggetti contrassegnati per l'eliminazione, salvo che tu li chieda. Le date non hanno fuso orario: sono l'ora locale della infobase. Gli importi sono nella valuta del documento, se il campo non dice altro.

Sola lettura: nessuno strumento scrive. Il connettore non crea, modifica, registra né elimina nulla, quindi non c'è niente da confermare e nessuno strumento è disattivato all'installazione. Il vero confine sono i diritti dell'utente 1C: 1C li controlla a ogni chiamata, e ciò che l'utente non può vedere non compare nella risposta, il che può sembrare un dato mancante.

Limiti: non c'è un limite fisso di chiamate, ma ogni query gira sul tuo server 1C. L'AI imposta sempre $top e $select su anagrafiche e registri grandi e scorre gli elenchi lunghi pagina per pagina.

Errori comuni: 401 significa che 1C ha rifiutato l'accesso: controlla nome utente, password e diritto di usare l'interfaccia OData standard. 403 significa che l'utente ha effettuato l'accesso ma non può leggere quell'oggetto: dai al suo ruolo il diritto di lettura. 404 significa che l'oggetto non è nella composizione OData, che il nome è scritto male o che ONEC_BASE_URL è sbagliato (non deve contenere /odata). 400 con "Ошибка при разборе опции запроса" indica un filtro o un nome di campo errato. 500 su una infobase file di solito significa che l'account del web server non ha diritti di scrittura sulla cartella della infobase.

Il connettore non crea, non registra e non elimina documenti, e vede solo gli oggetti che il tuo amministratore ha aggiunto alla composizione OData.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di 1C:Enterprise.

Tool disponibili

Esempi di prompt

• "Qual è oggi la giacenza di ogni articolo nel magazzino principale, e quali articoli sono sotto le 10 unità?"
• "Quanto abbiamo spedito a Romashka LLC a settembre, diviso per documento di vendita registrato?"
• "Trova il cliente con INN 7707083893 ed elenca le fatture che gli abbiamo emesso il mese scorso."
• "Quale cambio del dollaro USA è registrato in 1C per oggi?"
• "Qual è il saldo del conto 62.01 a fine settembre, e quali clienti lo compongono?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot