Come collegare Elasticsearch a Meta Muse via MCP

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

Elasticsearch + Meta Muse

Fai esplorare e interrogare alla tua AI il tuo cluster Elasticsearch su Elastic Cloud, Serverless o sui tuoi server: elenca indici e data stream, leggi i mapping, cerca, aggrega, conta, esegui ES|QL e, con la tua conferma, scrivi documenti.

Prerequisiti

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

ELASTICSEARCH_URL, ELASTICSEARCH_API_KEY

Step 1 — Ottieni le credenziali

1. Trova l'endpoint di Elasticsearch. Elastic Cloud Hosted: apri il deployment su https://cloud.elastic.co e copia l'Elasticsearch endpoint, per esempio https://my-deployment.es.europe-west3.gcp.cloud.es.io. Serverless: apri il progetto e copia il suo endpoint Elasticsearch. Self-managed: l'indirizzo HTTPS e la porta su cui risponde il tuo cluster, per esempio https://search.example.com:9200. Incollalo in ELASTICSEARCH_URL senza barra finale. Usa l'endpoint di Elasticsearch, non l'indirizzo di Kibana.
2. Crea una API key in Kibana da Stack Management → API keys → Create API key (Serverless: impostazioni del progetto → API keys). Dalle un nome, per esempio anythingmcp, una scadenza e attiva Control security privileges per limitarla (vedi sotto).
3. Copia il valore Encoded (base64): Elastic lo mostra una sola volta. Incollalo in ELASTICSEARCH_API_KEY e installa il connettore. I valori id e api_key da soli non funzionano, e utente e password non sono supportati.
4. Verifica la configurazione con elasticsearch_whoami: non richiede privilegi e mostra a chi appartiene la chiave.

Dove gira il tuo cluster: Elastic Cloud Hosted, Elastic Cloud Serverless e cluster self-managed, dalla versione 8 in poi. AnythingMCP Cloud ha bisogno di un cluster raggiungibile da internet; un AnythingMCP self-hosted può raggiungere anche un cluster nella tua rete, dopo che un amministratore ha autorizzato quell'host.

Chiave in sola lettura (consigliata): usa questi role descriptor nel modulo di Kibana, oppure esegui la richiesta in Kibana Dev Tools e copia encoded dalla risposta:

POST /_security/api_key
{
  "name": "anythingmcp-read",
  "expiration": "365d",
  "role_descriptors": {
    "anythingmcp_read": {
      "cluster": ["monitor"],
      "indices": [
        { "names": ["*"], "privileges": ["read", "view_index_metadata", "monitor"] }
      ]
    }
  }
}

Sostituisci "*" con i pattern di indice che l'AI può vedere, per esempio ["products", "logs-*"]. read copre ricerca, conteggi, aggregazioni, ES|QL e singoli documenti; view_index_metadata copre mapping, alias e data stream; monitor copre l'elenco degli indici e lo stato del cluster. Una chiave non ha mai più diritti dell'utente che la crea.

Cosa può fare l'AI: elencare indici, alias e data stream; leggere il mapping dei campi di un indice prima di interrogarlo; cercare con la Query DSL (10 risultati per impostazione predefinita, al massimo 100 per chiamata); eseguire aggregazioni come conteggi per valore, somme, medie e istogrammi per data; contare le corrispondenze; eseguire query ES|QL per risposte in tabella (al massimo 500 righe); e leggere singoli documenti. I campi vettoriali più comuni restano fuori dai risultati. Lo stato del cluster non è disponibile su Serverless, dove il cluster lo gestisce Elastic.

Le scritture chiedono prima: elasticsearch_index_document crea o sostituisce un intero documento, e elasticsearch_update_document ne modifica alcuni campi. Prima di ognuna l'AI ti mostra indice, _id e contenuto e aspetta il tuo sì. Entrambe richiedono il privilegio write, quindi con la chiave in sola lettura qui sopra falliscono con 403: è proprio la rete di sicurezza voluta.

Disattivati all'installazione: elasticsearch_delete_document e elasticsearch_delete_by_query. Le eliminazioni non si possono annullare, e un delete by query può rimuovere milioni di documenti. Un amministratore li attiva consapevolmente; l'AI poi conta prima i documenti corrispondenti e chiede prima di eliminare.

Errori comuni: 401: la chiave è errata, scaduta o invalidata, oppure è stato incollato l'id invece del valore Encoded. 403 security_exception: alla chiave manca il privilegio indicato nel messaggio. 404 index_not_found_exception: nome di indice sconosciuto. 400 parsing_exception o verification_exception: la query contiene un errore; il messaggio indica il campo o la posizione. 429: il cluster è sovraccarico; attendi e riprova.

Il connettore parla solo con Elasticsearch, non con Kibana. Non crea né elimina indici, non modifica mapping o impostazioni e non copre snapshot, ingest pipeline, amministrazione della sicurezza e la bulk API.

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Elasticsearch.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Quali indici abbiamo, quanti documenti contiene ciascuno e quanto sono grandi?"
• "Cerca nell'indice products le cuffie wireless sotto i 100 euro e mostra nome, marca e prezzo."
• "Con ES|QL conta gli errori per host in logs- nelle ultime 24 ore e mostrami i primi 10."*
• "Quanti ordini al giorno abbiamo ricevuto a settembre? Usa un istogramma per data sull'indice orders."
• "Imposta a 0 il campo stock del prodotto 4711 nell'indice products. Mostrami la modifica prima di farla."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT