Server Axe MCP

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Panoramica

Il Server Axe MCP è un server Model Context Protocol (MCP) che integra i test di accessibilità a livello aziendale direttamente nel tuo flusso di lavoro di sviluppo. Basato sulla fidata piattaforma Axe, consente agli sviluppatori di eseguire scansioni di accessibilità complete e di ricevere indicazioni esperte per la risoluzione dei problemi senza lasciare il loro IDE.

Il server fornisce due strumenti: analyze, che scansiona una pagina e può eseguire Test guidati intelligenti contro di essa nella stessa chiamata, e remediate, che trasforma i problemi trovati in correzioni di codice. Un terzo strumento, igt, è deprecato.

Questi strumenti si integrano perfettamente con client compatibili con MCP (come Claude Desktop, VS Code con Copilot, o Cursor) e rispettano le impostazioni di Configurazione Axe della tua organizzazione.

Accesso

Il Server Axe MCP è incluso nel pacchetto bundle Axe DevTools per Web. Un abbonamento che abilita l'accesso al Server Axe MCP viene impostato parlando con un rappresentante commerciale di Deque.

Strumenti e Capacità

Lo Strumento analyze

Esegue una scansione di una pagina web alla ricerca di problemi di accessibilità in un browser reale, con l'estensione del browser Axe DevTools, e restituisce i risultati al tuo agente. Funziona con URL di sviluppo locale come localhost:3000 e con URL remoti, e rispetta Configurazione Axe della tua organizzazione.

Le opzioni ti permettono di eseguire la scansione a una dimensione del viewport specifica, delimitare la scansione a parte della pagina, accedere o chiudere i banner prima della scansione, iniettare cookie, catturare uno screenshot, e eseguire Regole avanzate.

Vedi Strumento di Analisi.

Test guidati intelligenti

Lo strumento analyze può anche eseguire i Test Guidati Intelligenti Automatici (IGTs) di Deque contro la stessa pagina, nella stessa chiamata: gli IGT Tastiera, Elementi Interattivi e Dialogo Modale. Gli IGT sono alimentati da AI e consumano Crediti AI.

Vedi Test guidati intelligenti.

Lo Strumento remediate

Prende i problemi analyze trovati e restituisce una guida alla correzione basata su AI, inclusa una correzione concreta del codice, che il tuo agente di codifica può applicare. Invia ogni problema da un'analisi in un'unica chiamata raggruppata. Ogni problema consuma Crediti AI.

Vedi Strumento di Correzione.

Lo Strumento igt

Deprecato. Usa analyze con il parametro igtTools invece. Vedi Lo Strumento igt.

Introduzione

Configurare il Server Axe MCP comporta tre scelte indipendenti:

  1. Scegli una distribuzione — Docker o npm
  2. Imposta l'autenticazione — una chiave API o OAuth 2.0
  3. Configura il tuo client — VS Code con Copilot, Cursor, o **Claude Code**

Gli utenti di Claude Code possono saltare questi passaggi con il Plugin di Accessibilità Axe, che registra il server e aggiunge comandi slash per l'impostazione, le istruzioni dell'agente e l'esecuzione completa del ciclo di correzione.

Per le variabili d'ambiente e le istruzioni raccomandate per gli agenti IA, vedi Riferimento di Configurazione. Se qualcosa va storto, vedi Risoluzione dei problemi.

Esempi di prompt

Garantire il richiamo degli strumenti attesi

In molti IDE, usando la seguente sintassi (prefisso "#") si garantirà l'esecuzione degli strumenti del Server Axe MCP come previsto:

#analyze the http://localhost:3033/ web page for accessibility issues and #remediate any violations found

Analizzare un URL localhost per problemi di accessibilità:

Analyze http://localhost:3000 for accessibility issues

Analisi con correzione:

Analyze https://example.com for accessibility issues and fix any issues found

Analizzare una pagina dietro un login:

Analyze http://localhost:3000 for accessibility issues. Before running the
analysis, fill in the #username and #password fields with USERNAME and
PASSWORD from ./.env.local, click the button[type=submit] button, and
wait for #main-content to appear.
Analyze https://example.com for accessibility issues, but first click the
#cookie-dismiss button to dismiss the cookie consent banner.

Cattura uno screenshot della pagina:

Analyze http://localhost:3000 for accessibility issues and capture a screenshot of the page

Scansiona una pagina con un cookie di sessione iniettato:

Analyze https://app.example.com for accessibility issues. Set the session
cookie for app.example.com from ./.env.local so the scan starts already
logged in.

Esegui ogni test guidato in una chiamata:

Analyze http://localhost:3000 for accessibility issues with thorough
advanced rules. Also run the keyboard, interactive elements, and modal
guided tests (test the modal triggered by button#open-dialog).

Scegli quali elementi interattivi testare:

Analyze http://localhost:3000 and run the interactive elements guided test.
Show me the interactive elements it finds first and let me choose which
ones to test.

Testa un dialogo modale:

Analyze http://localhost:3000 and run the modal guided test on the dialog
opened by #open-dialog

Supporto

Per domande, problemi o feedback riguardo al Server Axe MCP:

Sicurezza e Privacy

Per sapere cosa il server invia a Deque, cosa memorizza, e quale accesso necessita il tuo agente AI, vedi la FAQ Sicurezza & Privacy.

Is this page helpful?

Help us improve this page

Still need help?