Model Context Protocol

    Strumenti per agenti AI su Taxcoder.cz

    Accesso leggibile dalle macchine al marketplace Taxcoder per ChatGPT, Claude e altri assistenti compatibili con MCP.

    Taxcoder.cz è un marketplace online che collega gli utenti con specialisti fiscali verificati nella Repubblica Ceca. Gli agenti AI possono utilizzare strumenti di sola lettura tramite il Model Context Protocol (MCP). Qui sotto trovi gli strumenti disponibili e le istruzioni per collegare Taxcoder a Claude o ChatGPT.

    Strumenti disponibili

    Pubblico

    Sfogliare le categorie fiscali

    Elenca le aree di competenza attive, come imposta sul reddito, IVA e imposte societarie. Gli agenti usano le categorie invece di elencare specialisti per nome o ID.

    list_tax_categories
    Pubblico

    Cercare specialisti per categoria

    Restituisce specialisti approvati e disponibili con biografia, credenziali, link KDP ČR, competenze, valutazione, numero di recensioni e link al profilo.

    search_specialists
    Pubblico

    Profilo di uno specialista

    Restituisce biografia pubblica, credenziali, servizi con prezzi in CZK, recensioni recenti e link alla pagina dello specialista.

    get_specialist
    Accesso richiesto

    I miei acquisti di servizi

    I Suoi acquisti come cliente e le vendite come specialista, distinti per direzione, con importi in CZK, stato, scadenze e link per gestire o recensire.

    list_my_purchases
    Accesso richiesto

    Le mie proposte personalizzate

    Proposte ricevute come cliente e inviate come specialista, prezzi in CZK, stato e link alle conversazioni per valutare un’offerta non pagata o ricontattare il cliente. Pagamenti solo su Taxcoder.

    list_my_proposals
    Accesso richiesto

    Attività delle mie conversazioni

    Solo dati della conversazione: nome della controparte se accessibile, data dell’ultimo messaggio, numero di non letti e se l’ultimo messaggio è della controparte. Nessun testo, documento o allegato. Risponda su Taxcoder.

    list_my_conversations
    Accesso richiesto

    I miei servizi da specialista

    I Suoi servizi attivi e inattivi, con prezzi fissi, per unità o su richiesta. Crei o gestisca i servizi sul sito; lo strumento non li modifica.

    list_my_services

    Come funziona l’accesso

    • Gli strumenti pubblici restituiscono solo informazioni già visibili su taxcoder.cz e non richiedono accesso. Gli agenti vedono esattamente gli stessi specialisti della directory del sito: profili approvati che accettano pagamenti online sicuri.
    • Tutti gli strumenti sono di sola lettura. Gli agenti non possono prenotare, pagare, inviare messaggi o modificare dati.
    • Ogni risultato include un link pertinente a taxcoder.cz, dove l’utente può continuare in sicurezza.

    Per chi sviluppa agenti

    Come collegare Taxcoder al tuo assistente

    Taxcoder utilizza un unico indirizzo di connettore. Incollalo una volta sola: gli strumenti di ricerca funzionano subito, senza account.

    Indirizzo del connettore
    https://taxcoder.cz/mcp

    L’indirizzo completo è mostrato sopra il pulsante. Clicca il pulsante per copiarlo, poi incollalo nel campo “URL del server MCP” del tuo assistente quando aggiungi il connettore.

    Facoltativo: collega il tuo account Taxcoder

    Utilizzi lo stesso indirizzo /mcp per la ricerca pubblica o l’accesso all’account con OAuth. Accedendo subito mantiene tutti e tre gli strumenti pubblici e aggiunge quattro strumenti personali. Può collegarsi anche dopo, se l’assistente lo supporta; aggiorni l’elenco degli strumenti dopo il consenso. Se ha scelto “Nessuna autenticazione”, potrebbe dover modificare il connettore in OAuth o aggiungere l’indirizzo dell’account qui sotto. Taxcoder non può cambiare l’impostazione di autenticazione del Suo assistente.

    https://taxcoder.cz/mcp-account

    Per accedere all’account in ChatGPT, selezioni OAuth, non “Nessuna autenticazione”; in Claude Code, apra /mcp e autentichi Taxcoder. Claude, Perplexity e altri client possono utilizzare gli strumenti personali solo se supportano MCP remoto con OAuth. Dopo il consenso, chieda acquisti, vendite, proposte ricevute e inviate, attività delle conversazioni o servizi propri. Pagamenti e checkout avvengono sempre su taxcoder.cz, mai in una chat AI. Non inserisca password o token nella chat o nella configurazione.

    Claude (Desktop e web)

    1. Apri Impostazioni → Connettori e scegli “Aggiungi connettore personalizzato”.
    2. Inserisci il nome “Taxcoder” e incolla l’indirizzo del connettore riportato sopra nel campo “URL del server MCP”.
    3. Conferma con “Continua”. Gli strumenti di ricerca funzionano subito e non serve accedere a Taxcoder.
    4. Apri una nuova conversazione: gli strumenti Taxcoder sono ora disponibili.

    Claude Code (riga di comando)

    claude mcp add --transport http --scope user taxcoder https://taxcoder.cz/mcp
    claude mcp add --transport http --scope user taxcoder-account https://taxcoder.cz/mcp-account
    La finestra “Aggiungi connettore personalizzato” di Claude, con l’indirizzo del connettore Taxcoder inserito nel campo “URL del server MCP”.
    La finestra “Aggiungi connettore personalizzato” di Claude, con l’indirizzo del connettore Taxcoder inserito nel campo “URL del server MCP”.

    ChatGPT

    1. Apri Impostazioni → Connettori (o Connettori in modalità sviluppatore, se attiva).
    2. Scegli “Crea” / “Aggiungi connettore personalizzato” e inserisci il nome “Taxcoder”.
    3. Incolli l’indirizzo del connettore riportato sopra. Scelga “Nessuna autenticazione” per i soli strumenti pubblici, oppure OAuth per collegare il Suo account. Se disponibile, con l’opzione combinata OAuth / nessuna autenticazione l’accesso successivo dipende dal supporto dell’assistente.
    4. Con OAuth, autorizzi l’accesso su Taxcoder: saranno disponibili tutti e sette gli strumenti, inclusi i tre pubblici. Senza autenticazione la ricerca pubblica funziona subito; per accedere dopo potrebbe dover modificare l’impostazione del connettore o aggiungere quello dell’account qui sotto.
    5. Salva e attiva Taxcoder nel selettore degli strumenti della chat.

    Prova con queste richieste

    • “Quali categorie fiscali sono disponibili su Taxcoder?”
    • “Trova specialisti IVA verificati su Taxcoder.”
    • “Mostrami il profilo Taxcoder di questo specialista.”

    Altri agenti compatibili con MCP

    Utilizzi una connessione HTTP a https://taxcoder.cz/mcp. Gli strumenti pubblici funzionano senza autenticazione; OAuth sullo stesso indirizzo aggiunge gli strumenti personali senza rimuovere quelli pubblici. Per i client che accettano la configurazione mcpServers, può utilizzare l’esempio seguente; i nomi dei campi possono variare tra client.

    {
      "mcpServers": {
        "taxcoder": {
          "type": "http",
          "url": "https://taxcoder.cz/mcp"
        }
      }
    }

    Verifichi la connessione chiedendo all’agente di elencare le categorie fiscali di Taxcoder. Dovrebbe utilizzare list_tax_categories; search_specialists e get_specialist restituiscono poi profili pubblici con i relativi link.

    Se gli strumenti non compaiono, attivi Taxcoder nell’assistente e apra una nuova conversazione. Utilizzi un client MCP con supporto HTTP, non una scheda del browser. I connettori personalizzati possono richiedere la modalità sviluppatore o l’autorizzazione dell’amministratore dello spazio di lavoro.