05 — Get Started · MCP

ESTENDI L'AI CON MCP .

Connetti Noeva al tuo LLM client preferito in 4 step. Niente deploy, niente backend custom: solo la tua personal API key e una manciata di righe JSON nel config del client.

PARLA CON IL TEAM INIZIA

Server MCP

Client supportati

Tool esposti

JSON-RPC 2.0

Protocollo

Step 01

Scegli il tuo client

Selezione il client MCP che usi ogni giorno. Mostriamo una rosa dei più famosi — il config che generiamo è compatibile con qualsiasi client conforme allo standard MCP.

Step 02

Cosa ti dà Noeva

Due server MCP production-ready: Core copre workspace, file, processi e knowledge graph; CRM copre lead, aziende, offerte, attività, timbrature. Stesso login, stessa API key.

Noeva Core MCP

IN PRODUZIONE 7 TOOL FAMILIES

Workspace, file, processi e knowledge graph — direttamente nel tuo LLM client.

npm @my-ginkgo/noeva-core-mcp

http https://core-mcp.noeva.ai

// TOOL ESPOSTI · 7

01
core_workspaces
Lista, membri, consumi e dashboard metrics dei workspace.
02
core_files
Ricerca, lettura, upload, crawl URL e pipeline AI-ready.
03
core_folders
Tree, navigazione, creazione, rinomina e associazione file.
04
core_search
Ricerca semantica e keyword cross-workspace.
05
core_processes
Polling job background: stato, dettaglio, aggregati.
06
core_tags
Tag e categorie: lista, assegnazione, unassign.
07
core_graph
Knowledge graph V5: topologia, percorsi, cluster tematici.

Noeva CRM MCP

IN PRODUZIONE 14 TOOL FAMILIES

Lead, aziende, offerte, attività, timbrature e graph CRM — esposti come tool MCP.

npm @my-ginkgo/noeva-crm-mcp

http https://crm-mcp.noeva.ai

// TOOL ESPOSTI · 14

01
crm_leads
CRUD lead con assegnazione, status, valore stimato.
02
crm_companies
CRUD aziende con P.IVA, settore, indirizzo, geocoding.
03
crm_offers
CRUD offerte con custom field e gestione amount.
04
crm_activities
Task con priorità, assegnatari, calendar slot.
05
crm_templates
Template offerte: schema, default, assegnazione.
06
crm_locations
Locations con link a aziende/lead/utenti.
07
crm_assets
Allegati file a entità CRM.
08
crm_vocab
Tag, categorie e classificazioni.
09
crm_punches
Timbrature in/out con motivazione e geo.
10
crm_notifications
Notifiche utente: lettura, mark-read, archive.
11
crm_dashboard
Metriche, leaderboard e stats aggregate.
12
crm_explore
Graph explorer: nodi, vicini, dettaglio.
13
crm_search
Full-text cross-entità CRM.
14
crm_members
Membri workspace e ruolo del caller.

Step 03

Prendi la tua API key

Apri Noeva → Profilo → API Keys → Crea. Copia il token in formato `noeva_sk_…`. È legato al tuo utente: gli MCP avranno esattamente i permessi del tuo workspace, mai di più.

Apri Noeva

app.noeva.ai/login

Profilo → API Keys

Sidebar utente · settings

Crea API Key

Copia il token noeva_sk_…

NOEVA_API_KEY=noeva_sk_xxxxxxxxxxxxxxxxxxxxxxxx
NOEVA_API_BASE_URL=https://api.noeva.ai

Step 04

Incolla la config

Apri il file di config del tuo client e incolla questo snippet. Riavvia il client: i tool Noeva compariranno automaticamente.

// CLIENT Claude Desktop · Anthropic

Documentazione client

// PERCORSO FILE

macOS · ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows · %APPDATA%\Claude\claude_desktop_config.json

// TRASPORTO

Esegue il server localmente via npx. Più semplice, nessuna dipendenza da endpoint Noeva.

// CONFIG · JSON

{
  "mcpServers": {
    "noeva-core": {
      "command": "npx",
      "args": [
        "-y",
        "@my-ginkgo/noeva-core-mcp"
      ],
      "env": {
        "NOEVA_API_KEY": "noeva_sk_xxx",
        "NOEVA_API_BASE_URL": "https://api.noeva.ai"
      }
    },
    "noeva-crm": {
      "command": "npx",
      "args": [
        "-y",
        "@my-ginkgo/noeva-crm-mcp"
      ],
      "env": {
        "NOEVA_API_KEY": "noeva_sk_xxx",
        "NOEVA_API_BASE_URL": "https://api.noeva.ai"
      }
    }
  }
}

VUOI ESPORRE UN ALTRO DOMINIO COME MCP?

Stiamo aggiungendo nuovi server MCP su cadenza trimestrale. Se hai un dominio specifico (procurement, contabilità, ticketing) parliamone: lo prioritizziamo in roadmap.

PARLA CON IL TEAM Vedi i tool nativi