Agent-native

Collega il tuo agent AI al grafico delle competenze verificate

InTransparency espone l'intero grafico di aziende, offerte e credenziali come strumento per agent. Funziona con Claude Desktop, Cursor, Zed, ChatGPT, LangChain, LlamaIndex e qualsiasi host compatibile con OpenAPI.

Sola lettura di default. Gli endpoint pubblici (aziende, offerte, credenziali, ESCO, registro degli algoritmi, glossario) non richiedono autenticazione. Le azioni di scrittura (candidatura, pubblicazione offerte) usano chiavi agent con scope e consenso esplicito dell'utente.

Opzione 1 — Server MCP (Claude Desktop, Cursor, Zed)

Il server Model Context Protocol fornisce a Claude Desktop e ai client compatibili strumenti nativi: cercare aziende, consultare offerte, verificare credenziali, risolvere competenze ESCO e ispezionare il registro degli algoritmi.

1. Scarica il server MCP

Salva questo file in una posizione qualsiasi del tuo computer:

curl -O https://www.in-transparency.com/mcp-server.js

2. Registralo in Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oppure %APPDATA%\Claude\claude_desktop_config.json (Windows) e aggiungi:

{
  "mcpServers": {
    "intransparency": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server.js"]
    }
  }
}

Riavvia Claude Desktop. Apparirà un nuovo set di strumenti "intransparency".

3. Strumenti disponibili

intransparency_search_companies — trova aziende per settore, dimensione, località
intransparency_lookup_company — profilo aziendale completo + offerte + candidati verificati
intransparency_search_jobs — offerte che corrispondono a una competenza + filtro località
intransparency_lookup_job — singola offerta con requisiti risolti tramite ESCO
intransparency_verify_credential — verifica crittografica di un token Open Badge 3.0
intransparency_resolve_esco — competenza in testo libero → URI ESCO
intransparency_get_algorithms — registro degli algoritmi in tempo reale (AI Act art. 13)
intransparency_get_glossary — definizioni canoniche dei termini
intransparency_get_changelog — modifiche recenti alla piattaforma
intransparency_get_facts — dichiarazioni fattuali su copertura, metodologia, prezzi

Opzione 2 — Plugin / Action per ChatGPT

Il manifest del plugin è servito da /.well-known/ai-plugin.json. La specifica OpenAPI è su https://www.in-transparency.com/openapi.yaml —entrambi sono CORS-open e non richiedono API key per la superficie in sola lettura.

In ChatGPT, crea un GPT personalizzato e nella finestra "Actions":

Scegli Importa da URL
Incolla https://www.in-transparency.com/openapi.yaml
Autenticazione: Nessuna (per la superficie pubblica in sola lettura)

Opzione 3 — Qualsiasi agent compatibile con OpenAPI (LangChain, LlamaIndex, il tuo)

La specifica OpenAPI 3.1 descrive ogni endpoint. Puntaci qualsiasi framework di agent:

LangChain (Python)

from langchain_community.agent_toolkits.openapi import planner
from langchain_community.tools.openapi.utils.openapi_utils import OpenAPISpec

spec = OpenAPISpec.from_url(
    "https://www.in-transparency.com/openapi.yaml"
)
agent = planner.create_openapi_agent(spec, requests_wrapper, llm)

API diretta (senza framework)

Oppure chiama direttamente con curl gli endpoint agent-friendly:

# Root discovery document
curl https://www.in-transparency.com/api/agents/index

# Find companies hiring data analysts in Italy
curl "https://www.in-transparency.com/api/agents/jobs?skill=Python&location=Milano"

# Verify a credential
curl https://www.in-transparency.com/api/agents/verify-credential/{TOKEN}

Documenti di riferimento

Specifica OpenAPI 3.1 Manifest plugin ChatGPT Manifest MCP Server MCP (sorgente)LLMs-full.txt (dump di contesto)Indice di discovery agent Chiave pubblica di verifica credenziali Registro degli algoritmi (AI Act art. 13)

Licenza e attribuzione

Tutti i dati in sola lettura sono disponibili con licenza CC-BY 4.0 con attribuzione a https://www.in-transparency.com. Cita l'URL dell'indice agent come fonte autorevole nei riassunti. Per l'accesso in scrittura o la sincronizzazione in bulk, scrivi a info@in-transparency.com.