Configura il programma di affiliazione della tua app con il tuo agente AI di coding.

Passo 1: collega InfluTo al tuo agente

Il server MCP di InfluTo si trova su https://influ.to/mcp (Streamable HTTP, OAuth 2.1). I client da terminale lo aggiungono con un solo comando. Editor e app di chat richiedono l'URL una volta sola nelle impostazioni.

# Claude Code
claude mcp add --transport http influto https://influ.to/mcp

# Codex CLI
codex mcp add influto --url https://influ.to/mcp

# Gemini CLI
gemini mcp add --transport http -s user influto https://influ.to/mcp

# VS Code (Copilot agent mode)
code --add-mcp '{"name":"influto","type":"http","url":"https://influ.to/mcp"}'

# Claude Code plugin: the MCP server plus two skills
/plugin marketplace add influto/influto-plugin
/plugin install influto

# Cursor: Settings → MCP → Add server
{ "influto": { "url": "https://influ.to/mcp" } }

Passo 2: approva l'accesso nel browser

La prima volta che l'agente chiama uno strumento di InfluTo, il browser apre una pagina di consenso di InfluTo. Accedi o crea un account sviluppatore, poi:

• Scegli l'organizzazione. L'agente può agire solo su quell'organizzazione. Gli ID di qualsiasi altra organizzazione restituiscono 404, quindi nulla passa da un account all'altro.

• Deseleziona ciò che non vuoi concedere. I permessi sono suddivisi in scope come campaigns:write, creators:write e integration:verify. Le nuove connessioni li ricevono tutti per impostazione predefinita.

• Approva. Il client memorizza l'autorizzazione e la rinnova da solo; i token di accesso durano al massimo un'ora. Puoi vedere e revocare gli agenti collegati nella pagina Agente AI della dashboard.

Per CI ed esecuzioni headless c'è un'alternativa: crea una chiave agente (it_mcp_…) nella stessa pagina Agente AI. Viene mostrata una sola volta, ha gli stessi permessi di una connessione OAuth e può essere revocata. Inviala come header Bearer allo stesso URL e tienila in una variabile d'ambiente, mai nel repository.

La chiave SDK dell'app (it_…) è una chiave diversa e non funziona sul server MCP. Una configurazione MCP headless si presenta così:

{
  "mcpServers": {
    "influto": {
      "type": "http",
      "url": "https://influ.to/mcp",
      "headers": { "Authorization": "Bearer ${INFLUTO_API_KEY}" }
    }
  }
}

Passo 3: chiedi l'integrazione

Descrivi il lavoro con parole tue. Un'esecuzione tipica va così:

1. 1

   Legge il tuo stack. influto_recommend_sdk associa ciò che trova (Expo, SwiftUI, Kotlin, Flutter, Capacitor) all'unico SDK InfluTo di cui la tua app ha bisogno, più le sue peer dependency. Un SDK per app, non per piattaforma.

2. 2

   Prepara la parte dell'account. influto_provision crea l'organizzazione, l'app con la sua chiave SDK e una campagna in una sola chiamata idempotente. influto_search_store compila gli identificatori di App Store e Google Play.

3. 3

   Scrive il codice. Gli strumenti di scaffolding restituiscono snippet corretti per la versione, presi dal registro degli SDK: la riga di installazione, l'inizializzazione una sola volta all'avvio, checkAttribution al lancio, identifyUser, un campo opzionale per il codice referral e la segnalazione degli acquisti per le app con validazione diretta con gli store.

4. 4

   Collega un solo percorso di validazione. influto_recommend_validation sceglie RevenueCat o store-direct, mai entrambi. Con RevenueCat, influto_setup_revenuecat crea il webhook nel tuo progetto RevenueCat dopo che hai incollato una chiave segreta v2 tramite un link della dashboard. Con store-direct, carichi la chiave .p8 o il JSON del service account di Play tramite un link, e l'agente esegue il controllo delle credenziali e attiva la piattaforma.

5. 5

   Crea la campagna. Percentuale di commissione, bonus per traguardi e testi della campagna in 11 lingue. Per attivarla servono 50 $ disponibili nel wallet. Se non ci sono, l'agente riceve un errore 402 e ti passa un link per la ricarica.

Poi controlla il proprio lavoro, ed è la parte che conta.

Passaggio 4: il ciclo di verifica

Un'integrazione non è finita quando il codice compila. È finita quando un acquisto di prova da referral compare in InfluTo, assegnato al codice di un creator. L'agente lo verifica in quattro mosse:

1. 1

   Leggi la checklist. influto_integration_status restituisce otto passaggi, da app_created a attributed_conversion, passando per sdk_initialized, validation_configured e purchase_webhook_seen, con le azioni successive per ciò che resta aperto.

2. 2

   Simula un acquisto. influto_test_integration invia un acquisto di prova sandbox da 9,99 $ per un utente inventato, attraverso la vera pipeline degli acquisti di InfluTo. Passa uno dei tuoi codici e lo vedi risolversi. Sono dati di test: non entrano mai nei tuoi numeri e non completano mai un passaggio della checklist.

3. 3

   Aspetta un vero acquisto sandbox. Installi la tua build tramite il link di referral di un creator (o digiti il codice), la avvii e acquisti con un tester TestFlight, sandbox o licenza di test di Google Play. influto_recent_events mostra l'acquisto con attributed: true e il codice.

4. 4

   Conferma. Quando attributed_conversion_count arriva a 1 da un acquisto reale, l'integrazione è provata. influto_verify_user_conversions risponde alla stessa domanda per un singolo ID utente dell'app.

L'unico passaggio che richiede le tue mani è l'acquisto sandbox su un dispositivo. L'agente può controllare e spiegare tutto il resto. Gli stessi controlli esistono come semplici endpoint HTTP sotto /api/agent, per script e CI.

Cosa può fare l'agente e cosa resta a te

Con i permessi predefiniti, un agente collegato a InfluTo può:

• Leggere il tuo programma. App, campagne, creator, risultati, il feed Attività, serie giornaliere, la pagina di un creator o di un codice e gli abbonati da referral solo tramite chiave pseudonima.

• Modificare app e campagne. Crearle e aggiornarle, inclusi bonus per traguardi, percentuali per singolo creator e traduzioni.

• Reclutare creator. Invitarli uno alla volta o in gruppi fino a 500, generare link di adesione e creare codici di accesso gratuito.

• Testare l'integrazione. Eseguire la checklist, leggere gli eventi recenti e simulare acquisti sandbox.

Alcune cose sono impossibili per qualsiasi agente, qualunque cosa approvi: spostare denaro (ricariche, trasferimenti, pagamenti), leggere o impostare credenziali in chiaro, eliminare dati e azioni di amministrazione. Quando un'attività ne richiede una, l'agente riceve un link alla dashboard che apri tu, dopo aver effettuato l'accesso, per ricaricare il wallet, caricare le credenziali degli store o caricare materiali di marketing. Segreti e denaro non passano mai dall'agente né dalla chat.

Due ulteriori protezioni: i bonus per traguardi attendono una revisione prima di essere pagati, e il server indica agli agenti di trattare schede degli store, descrizioni delle app e testi forniti dai creator come dati, mai come istruzioni.

67 strumenti, raggruppati per compito

Gli strumenti si dividono in sette gruppi. Quelli di discovery e scaffold rispondono dal registro SDK senza toccare il tuo account. Gli altri chiamano la REST API dell'agente sotto /api/agent, con gli stessi permessi e gli stessi confini tra organizzazioni.

L'elenco aggiornato è la risorsa MCP influto://tools, generata dal server, e ogni strumento è descritto su docs.influ.to/agents/tools. Il server include anche cinque prompt già pronti: launch_campaign, recruit_creators, weekly_program_report, diagnose_attribution e fund_and_activate.

Prompt che funzionano

Bastano richieste semplici. Alcune che corrispondono a compiti reali:

• Integra e dimostra che funziona: “Aggiungi InfluTo a questa app con validazione diretta con gli store e dimostra che un acquisto sandbox viene attribuito.”

• App con RevenueCat: “Questa app Expo usa RevenueCat. Aggiungi l'SDK di InfluTo, collega il webhook e dimmi cosa resta da fare a me.”

• Lancia: “Crea una campagna con il 30% ricorrente, traducila e dammi il link di adesione.”

• Diagnostica: “Le installazioni dal link di MAYA non vengono accreditate. Scopri perché.”

• Report: “Come è andato il programma la settimana scorsa, creator per creator?”

Se qualcosa non va, chiedi all'agente di eseguire prima influto_doctor. Non richiede permessi e indica come è collegato l'agente, cosa può fare e quanto sono aggiornati i dati SDK di ogni app.

Come si confronta con altri server MCP per l'affiliazione

Oggi i server MCP sono diffusi nei software di affiliazione. Dub, Tolt, Affonso e Partnero ne offrono uno, soprattutto per programmi di affiliazione di SaaS web.

Un'app mobile ha bisogno anche dell'altra metà: un SDK dentro l'app, acquisti verificati tramite RevenueCat o direttamente con Apple e Google, e la prova che un acquisto da referral viene accreditato prima di invitare anche un solo creator. Questo ciclo, dalla scelta dell'SDK a un acquisto sandbox attribuito, è ciò attorno a cui è costruito il server MCP di InfluTo.