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. Scegliere Lascia che la mia IA si occupi della configurazione. se vuoi che l'IA integri Altified per te, o Solo lettura se dovrebbe solo ispezionare il tuo progetto. Ogni modifica richiede comunque la tua conferma.
  3. Crea un token. Dagli un nome come Cursor on my laptopI token creati da un progetto sono limitati a quel progetto.
  4. Copia immediatamente il token. Altified mostra il token completo una sola volta. Funziona come una password per lo strumento AI.
  5. Aggiungi Altified al tuo editor. Dopo la creazione del token, scegli il tuo editor nel pannello del token. Cursor e VS Code hanno un Installare pulsante; Claude Code ti fornisce un comando da eseguire; altri editor ottengono un JSON con il tuo token già inserito.
  6. Stai usando un altro editor? Cerca nelle sue impostazioni MCP, quindi scegli un'opzione come Aggiungi server, Nuovo server MCP, O Modifica configurazioneLa formulazione varia a seconda dell'editore.
  7. Incolla e salva la configurazione. Se l'editor accetta JSON, incolla la configurazione che hai copiato da Altified. Se richiede campi separati, usa l'URL del server, il 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. Chiedigli di integrarsi Altified. Apri la cartella della tua app nell'editor e chiedi: “Integrare Altified in questo progetto.” L'IA legge le istruzioni di configurazione del tuo progetto, ti mostra un piano, attende la tua approvazione, quindi installa l'SDK, posiziona il selettore della lingua e verifica che l'SDK sia connesso.

Run in your project's terminal.

claude mcp add --transport http altified https://mcp.altified.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Gli esempi sopra utilizzati YOUR_MCP_TOKEN come segnaposto. La pagina MCP del tuo progetto inserirà automaticamente il tuo token reale. Non pubblicare mai la configurazione completa.

Altre cose da chiedere

  • "Esegui un controllo di stato del mio progetto Altified." — Connessione SDK, chiave segreta, selettore, stato di avanzamento della traduzione, utilizzo e ultimo audit SEO.
  • “Aiutami a configurare il selettore di lingua Altified.” — rivedi lingua, ordine, etichette e stile, quindi pubblica dopo aver approvato.
  • “Quali traduzioni mancano per il francese?” — Elenca i contenuti mancanti o non riusciti e richiedi le traduzioni dopo averle approvate.

La tua IA ti dirà di creare la chiave segreta SDK nella dashboard e di incollarla in .env te stesso. MCP non crea né mostra mai chiavi segrete.

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.
  • projects:write — consente all'IA di richiedere modifiche al progetto e al selettore di lingua, inclusa la pubblicazione del selettore.
  • languages:write — consente all'IA di richiedere l'aggiunta o la rimozione di una lingua.
  • translations:write — consente all'IA di richiedere, riprovare o modificare le traduzioni, utilizzando il tuo budget di traduzione.

Ogni scrittura richiede comunque la tua conferma. Altified verifica anche la proprietà del progetto, i permessi del token e i limiti del piano. seo:write è riservato per azioni future.

Cosa non fa MCP

  • Non sostituisce la dashboard o l'SDK Altified.
  • Non fornisce all'IA il tuo database, i dettagli di pagamento o i segreti del back-end.
  • Non modifica automaticamente il codice sorgente; lo strumento di programmazione basato sull'IA apporta le modifiche al codice localmente.
  • Non consente a un token di progetto di accedere a un altro progetto Altified.

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.