Developer / MCP

Fare un passo 7 Di 25

Collega uno strumento di programmazione AI a Altified

MCP consente a strumenti come Cursor, Claude e agli agenti di VS Code di chiedere Altified informazioni su questo progetto ed eseguire azioni approvate per te.

MCP sta per Protocollo di contesto del modelloIn parole semplici, si tratta di una connessione sicura tra uno strumento di programmazione AI e il tuo progetto Altified. Lo strumento AI non si connette direttamente al tuo database. Comunica con il server MCP [[[1]], che verifica il tuo token e le autorizzazioni prima di utilizzare Altified.

La connessione si presenta così

Il tuo strumento di intelligenza artificiale → Altified Server MCP → Il tuo progetto Altified

Cosa sono le impostazioni MCP?

Le impostazioni MCP sono il luogo all'interno di un editor di codice AI in cui aggiungi strumenti esterni che l'IA può utilizzare. Non sono un'impostazione nella dashboard Altified. Cerca nel tuo editor un menu o un file chiamato MCP, Server MCP, Utensili, O Integrazioni.

L'editor deve supportare MCP. Un normale editor di testo senza assistente IA non può utilizzare questa connessione.

Configuralo dall'inizio alla fine

  1. Apri il tuo progetto. Nella dashboard Altified, apri il progetto che vuoi che il tuo strumento di programmazione AI utilizzi, quindi scegli MCP dalle schede di progetto o dalla navigazione del progetto.
  2. Scegli le autorizzazioni. I permessi di lettura consentono all'IA di esaminare il progetto. I permessi di scrittura consentono modifiche approvate, come l'aggiunta di una lingua. Se non sei sicuro, inizia con i permessi di lettura.
  3. Crea un token. Dagli un nome come Cursor on my laptopI token creati da un progetto sono limitati a quel progetto.
  4. Copy the token immediately. Altified mostra il token completo una sola volta. Funziona come una password per lo strumento AI.
  5. Copia la configurazione. Dopo la creazione del token, utilizzare Copia configurazione nel pannello dei token. Qui vengono copiate le informazioni di connessione JSON complete, inclusi l'URL del server e il token.
  6. Apri le impostazioni MCP del tuo editor di codice AI. Cerca nelle impostazioni dell'editor MCPQuindi scegli un'opzione come Aggiungi server, Nuovo server MCP, O Modifica configurazioneLa formulazione varia a seconda dell'editore.
  7. Incolla e salva la configurazione. If the editor accepts JSON, paste the configuration you copied from Altified. If it asks for separate fields, use the server URL, the Authorization intestazione e il token mostrato di seguito.
  8. Riavvia o ricarica l'editor. Alcuni editor si connettono ai nuovi server MCP solo dopo il riavvio dell'assistente AI o dell'editor. Approva o abilita il server Altified se l'editor lo richiede.
  9. Verifica la connessione. Chiedi all'IA dell'editore: “List my Altified project details and tell me whether the SDK is connected.” Una risposta positiva significa che l'editore può raggiungere Altified.
Configurazione generica del client MCP
{
  "mcpServers": {
    "altified": {
      "url": "https://mcp.altified.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

The example above uses YOUR_MCP_TOKEN come segnaposto. Usa Copia configurazione sulla pagina MCP in modo che il tuo token reale venga inserito automaticamente. Non pubblicare mai la configurazione completata.

Se il tuo editor utilizza campi separati

Campo EditoreCosa inserire
Server namealtifiedServer URLhttps://mcp.altified.com/mcpHeader nameAuthorizationHeader valueBearer YOUR_MCP_TOKEN

Il token è privato

Tratta il token MCP come una password. Non inserirlo in Git, in un problema pubblico, in uno screenshot, nel codice sorgente frontend o in un NEXT_PUBLIC_ variabile d'ambiente. Se è esposta, revocala in Altified e creane una sostitutiva.

Se non si connette

  • Il server non risulta visibile: Verifica che l'editor supporti MCP, quindi riavvialo o ricaricalo.
  • Accesso non autorizzato o 401: Copia nuovamente la configurazione, verifica che il token sia completo e assicurati che non sia stato revocato.
  • Permesso negato o 403: tornare a Altified e creare un token con l'autorizzazione richiesta. Un token di progetto non può accedere ad un altro progetto.
  • L'intelligenza artificiale non può cambiare nulla: verifica che il token abbia l'autorizzazione di scrittura necessaria e approva l'azione richiesta quando Altified chiede conferma.

Cosa significano le autorizzazioni

  • projects:read — consente all'IA di visualizzare i nomi dei progetti, i domini, le lingue e lo stato.
  • languages:read — consente all'IA di vedere le lingue supportate da Altified.
  • translations:read — consente all'IA di visualizzare l'avanzamento della traduzione.
  • seo:read — consente all'IA di leggere lo stato e i risultati dell'audit SEO.
  • integration:read — consente all'IA di leggere le informazioni di configurazione SDK sicure.
  • usage:read — consente all'IA di leggere le informazioni relative al piano e all'utilizzo.
  • languages:write — consente all'IA di richiedere l'aggiunta di una lingua, ma Altified richiede comunque la conferma.

Alcuni permessi di scrittura sono riservati per future azioni MCP. Altified verifica ancora la proprietà del progetto, i permessi del token, i limiti del piano e la conferma delle modifiche.

Cosa non fa MCP

  • It does not replace the Altified dashboard or SDK.
  • It does not give the AI your database, payment details, or backend secrets.
  • It does not automatically edit your codebase; the AI coding tool makes code changes locally.
  • It does not let a project token access another Altified project.

Revoca dell'accesso

Torna al progetto MCP pagina, trova il token e scegli RevocareLo strumento di intelligenza artificiale non sarà più in grado di connettersi con quel token. Crea un nuovo token se perdi quello vecchio o lo condividi accidentalmente.

Hai bisogno invece della normale integrazione dell'applicazione? Continua con Guida alla configurazione dell'SDK.