Come collegare Medmis a Cursor via MCP

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

Medmis + Cursor

Medmis, la piattaforma di gestione per cliniche (Russia): sedi, specialisti e agende, appuntamenti, pazienti, fatture, pagamenti, listino, magazzino, attività e visite di medicina del lavoro. Prenotare o modificare un appuntamento e creare un'attività sono inclusi, ma disattivati all'installazione; non viene eliminato nulla.

Prerequisiti

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

MEDMIS_URL, MEDMIS_LOGIN, MEDMIS_PASSWORD, MEDMIS_SYSTEM_NAME

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account clinica Medmis e un utente API fornito dal supporto Medmis o dal tuo amministratore Medmis.

1. Chiedi al supporto Medmis ([email protected], con l'oggetto contrassegnato DEV / API_CORE) o al tuo amministratore Medmis un utente API: un login, la sua password e il nome di sistema usato per l'accesso. I permessi dell'utente API decidono cosa possono leggere i tool (appointments.get, patients.get, patient_invoices.get, payments.get, schedules.get, stores.get, todo.tasks.get, profex.* e così via).
2. Imposta MEDMIS_URL sull'indirizzo del nodo Medmis della tua clinica, ad esempio https://node3.medmis.ru, senza /apix. Il riferimento dell'API si trova su <MEDMIS_URL>/apix/swagger.
3. Compila MEDMIS_LOGIN, MEDMIS_PASSWORD (almeno 6 caratteri) e MEDMIS_SYSTEM_NAME.
4. Installa il connettore ed esegui medmis_list_branches per verificare l'accesso.

Il connettore accede con POST /apix/v1/Auth/login e invia l'access token come header Bearer. I token durano circa un'ora e vengono rinnovati automaticamente.

Cosa legge: le sedi della clinica con indirizzo, contatti, orari, licenza e fuso UTC; gli specialisti con le loro specializzazioni e sedi, e le prestazioni che ciascuno può erogare; l'agenda degli specialisti per una o più sedi e un intervallo di date, anche solo con gli slot liberi; gli appuntamenti con orari UTC e locali, stato, paziente, specialista, origine, tipo di visita, ambulatorio e tag, più le loro liste di riferimento (stati, tipi, prima visita o controllo, origini, tag); i pazienti per nome, telefono, e-mail, numero di cartella, data di nascita o età, sesso, tag e altro, e la scheda completa di un paziente; le fatture dei pazienti con le loro righe, e i pagamenti con gli importi per metodo di pagamento; il listino (categorie di prestazioni e prestazioni); le riserve (tempo bloccato nell'agenda di uno specialista); i magazzini, l'anagrafica dei materiali, le giacenze e i lotti con scadenza; le attività interne; e il modulo di medicina del lavoro (Профосмотры): aziende, contratti e le persone che vi rientrano.

Disattivati all'installazione: medmis_create_appointment (prenota uno slot libero), medmis_update_appointment (sposta un appuntamento, lo annulla o conferma tramite lo stato, cambia commento o tag) e medmis_create_task. Modificano l'agenda reale della clinica, quindi un amministratore li attiva consapevolmente. Anche allora l'AI ti mostra paziente, specialista, giorno e ora e aspetta il tuo sì. Tramite questo connettore non viene mai eliminato nulla.

Dati dei pazienti: pazienti, appuntamenti, fatture e pagamenti sono dati personali sanitari. L'AI legge solo ciò che serve alla domanda e non ripete documenti d'identità o dati di contatto se non lo chiedi tu. L'elenco dei pazienti omette i numeri dei documenti d'identità, INN e SNILS.

Date e id: i filtri per giorno sono YYYY-MM-DD; i filtri per data di modifica sono yyyy-MM-ddTHH:mm:ss in UTC. Gli appuntamenti riportano sia l'ora UTC sia quella locale (datetimeFromLocal) più utcOffsetMinutes, e l'AI cita l'ora locale. Sedi, specialisti, pazienti, appuntamenti e pagamenti usano UUID; fatture, magazzini, materiali, attività e record delle visite usano numeri.

Limiti: le liste restituiscono items con totalCount e totalPages, al massimo 100 per pagina, a partire dalla pagina 1. Medmis limita ogni metodo: liste filtrate 20 richieste al minuto, liste di riferimento 40, singoli record 100 e accesso 40 al minuto. Un 429 significa attendere.

Errori comuni: 401 indica login, password o nome di sistema errati, oppure una sessione scaduta (il connettore riaccede una volta). 403 significa che all'utente API manca il permesso per quel metodo. 400 ValidationError elenca i campi errati, ad esempio una password più corta di 6 caratteri o una data malformata. 404 significa che l'id non esiste sul tuo nodo.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Medmis.

Tool disponibili

Esempi di prompt

• "Quali specialisti hanno slot liberi domani pomeriggio nella nostra sede principale?"
• "Elenca gli appuntamenti di oggi dei cardiologi con stato e ora locale di inizio."
• "Quanto abbiamo fatturato la settimana scorsa per sede, e quali fatture non sono ancora pagate?"
• "Quali materiali di magazzino hanno lotti scaduti, e quanto ne resta in giacenza per ciascuno?"
• "Mostrami i contratti di medicina del lavoro creati questo mese e quante persone rientrano in ciascuno."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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