Anslut en AI-agent med MCP

Välj din klient

Slutpunkt: https://mcp.fairvalid.com/mcp. Transport: Streamable HTTP.

Anslut med en API-nyckel eller OAuth-inloggning. Behöriga anslutningar från ChatGPT, Claude och Grok kan använda OAuth; se kraven på konto och roll för din klient nedan. Codex, Claude Code och Hermes stöder även direkta anslutningar med API-nyckel.

För klienter med API-nyckel skapar du en namngiven testnyckel i API-nycklar som ägare eller ansvarig för arbetsytan. Spara den i klientens skyddade inloggningsuppgifter eller dokumenterade miljöinställningar. Lägg aldrig en nyckel i en prompt, ett verktygsargument, en URL eller en incheckad konfiguration.

OAuth-flödet öppnar fairvalid.com för inloggning och samtycke. Du väljer en befintlig Live-API-nyckel som täcker de begärda behörigheterna och granskar dess arbetsyta och totala tak. Godkännandet beviljar de begärda behörigheterna tillsammans, inom nyckelns omfång. Du behöver inte klistra in nyckeln i AI-klienten. Om du återkallar den valda nyckeln avslutas även dess anslutningar. OAuth använder live-nycklar; använd en direkt anslutning med testnyckel för sandlådan.

Klientinstruktionerna granskades den 23 oktober 2026. Det hostade MCP-protokollet har klarat produktionsgodkännande med den officiella SDK:n. Det innebär inte att varje namngiven klient har testats; genomför anslutningskontrollen i din klient innan du förlitar dig på den.

ChatGPT

Använd OAuth-konfigurationen nedan. Nuvarande anpassade MCP-anslutningar kräver ChatGPT Business eller Enterprise/Edu på webben, med behörighet att skapa plugins med MCP:er. Business kräver en administratör eller ägare; Enterprise/Edu kan auktorisera utvalda medlemmar.

1. Öppna Plugins, välj plusknappen och sedan Lägg till anpassad MCP-server. Det nuvarande Plugins-flödet kräver inte utvecklarläge.
2. Ge anslutningen namnet FairValid och ange https://mcp.fairvalid.com/mcp som offentlig HTTPS-slutpunkt.
3. Välj OAuth med automatisk klientregistrering. FairValid använder offentlig klientregistrering: du behöver inte ange något klient-ID eller klienthemlighet. Ange aldrig en API-nyckel i något av fälten.
4. Slutför FairValid-inloggningen och samtycket som beskrivs ovan. Läs ChatGPT:s varning, välj sedan Create as a plugin och granska de sex upptäckta verktygen.
5. Installera pluginet, öppna en ny konversation, skriv @ och välj FairValid. Kör den skrivskyddade anslutningskontrollen nedan innan du begär en riktig verifiering.

Officiell dokumentation: OpenAI: anslut en anpassad MCP-server · OpenAI: OAuth-autentisering

Claude på webben och Desktop

Använd en fjärransluten anpassad koppling med OAuth. Det är samma kontobaserade anslutning i Claude på webben och Desktop; den går via Anthropics servrar. I Team och Enterprise lägger en ägare av organisationen först till kopplingen. Enterprise-medlemmar med en anpassad roll som hanterar organisationens bibliotek kan också lägga till den.

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

1. Öppna Anpassa → Kopplingar → Lägg till anpassad koppling. För en hanterad organisation börjar en ägare eller behörig Enterprise-roll i Organisationsinställningar → Kopplingar → Lägg till → Anpassad → Webb.
2. Ange FairValid och https://mcp.fairvalid.com/mcp.
3. Välj Sign in now. Om ett val av OAuth-klient visas, välj Register automatically. Lämna fälten för manuellt registrerat klient-ID och hemlighet tomma.
4. Logga in på fairvalid.com, granska den valda live-nyckeln och behörigheterna och godkänn anslutningen. Aktivera FairValid via konversationens kopplingsinställningar.
5. Kör den skrivskyddade anslutningskontrollen nedan. Använd sandlådekontrollen endast om du anslöt med en test-API-nyckel via Request headers.

Officiell dokumentation: Anthropic: anpassade connectors och autentisering · Anthropic: tillgänglighet för fjärranslutna connectors

Claude Code

Claude Code stöder en direkt anslutning med API-nyckel. Ange FAIRVALID_API_KEY i miljön som startar Claude Code och använd en testnyckel för den första kontrollen. Håll den faktiska hemligheten utanför projektfilerna.

1. Slå samman konfigurationen nedan med projektets .mcp.json. Behåll eventuella befintliga servrar. Den bokstavliga miljöreferensen ska stå i filen, men inte själva nyckelvärdet.
2. Starta Claude Code med FAIRVALID_API_KEY tillgänglig. Godkänn projektets MCP-konfiguration om du blir ombedd.
3. Kör claude mcp list och granska sedan /mcp i sessionen. Bekräfta att FairValid ansluter och exponerar sex verktyg och utför sedan sandlådekontrollen nedan.

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

Officiell dokumentation: Anthropic: MCP-konfiguration för Claude Code

Hermes Agent

Dessa instruktioner gäller NousResearch Hermes Agent. Dess fjärranslutna HTTP-transport stöder bearer-headers. CLI:t sparar nyckeln i din aktiva profils .env som MCP_FAIRVALID_API_KEY och behåller en miljöreferens i config.yaml.

1. Kör add-kommandot nedan. Svara ja när du tillfrågas om autentisering krävs och ange sedan en test-API-nyckel i den maskerade prompten för API key / Bearer token.
2. Granska de identifierade verktygen och aktivera de FairValid-verktyg du behöver. Anslutningen måste lyckas; att spara en inaktiverad anslutning efter ett fel räknas inte som en lyckad konfiguration.
3. Kör hermes mcp test fairvalid och starta sedan en ny session eller kör /reload-mcp. Utför sandlådekontrollen nedan. Hermes kan lägga till sitt serverprefix i verktygsnamnen.

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

Officiell dokumentation: NousResearch: MCP-konfiguration · NousResearch: kontroller av MCP-anslutning · NousResearch: CLI-implementering med header-autentisering

Grok Bot och Grok

Grok Bot och Grok.com konfigureras på olika ställen. I en personlig Grok Bot ber du Boten att lägga till FairValid med hjälp av förfrågan nedan. Det här sättet fungerar även när informationspanelen bara visar Details, Library och Computer, utan något Setup-avsnitt.

För Team Bots visas dessutom infopanelen → Setup → Plugins för botens ägare eller administratörer. Den inställningsvyn kräver Team Bot-åtkomst i skrivbordsappen. Varje teammedlem loggar in med sitt eget konto när OAuth används.

Grok.com använder grok.com/connectors → New Connector → Custom. Ange https://mcp.fairvalid.com/mcp och slutför autentiseringen. Business- och Enterprise-team kan behöva be sin administratör att först tillhandahålla anslutningen. Detta är en separat anslutning från ett Grok Bot-plugin.

En bot byggd med xAI API är också separat: dess utvecklare konfigurerar fjärr-MCP-headers i serverkoden. Dessa instruktioner påstår inte att Grok Bot erbjuder ett generellt fält för Authorization-header.

1. Be din bot att lägga till den anpassade Remote HTTPS MCP-anslutningen med begäran nedan. För en Team Bot kan även dess ägare eller chef använda Setup → Plugins.
2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
3. Slutför FairValid-samtycket på fairvalid.com. Varje teammedlem ansluter sitt eget konto där det krävs.
4. Be botten att lista FairValids verktyg och köra den skrivskyddade anslutningskontrollen nedan. Att verktygen hittas bevisar inte i sig att en verifiering har slutförts.

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

Officiell dokumentation: xAI: Grok Bot-plugins och Remote HTTPS · xAI: anpassade anslutningar för Grok.com · xAI: fjärr-MCP för API-utvecklare

Codex

Använd en direkt API-nyckelanslutning från Codex. Ange FAIRVALID_API_KEY i den miljö som är tillgänglig för Codex-processen och använd en testnyckel för din första kontroll. En skrivbordsapp som startas separat kanske inte ärver miljön från din terminal.

1. Kör kommandot nedan för att registrera den fjärranslutna Streamable HTTP-servern. Kommandot sparar miljövariabelns namn, inte API-nyckeln.
2. Kör codex mcp list och starta en ny Codex-session så att anslutningen läses in. Bekräfta att FairValid visas bland sessionens MCP-verktyg.
3. Om du använder Codex-appen, gör variabeln tillgänglig för dess körningsvärd och starta om appen eller öppna en ny session vid behov. Utgå inte från att en lyckad CLI-konfiguration har ändrat miljön för en app som redan körs.
4. Bekräfta sex upptäckta verktyg och gör sandlådekontrollen nedan.

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

Officiell dokumentation: OpenAI: MCP-konfiguration för Codex

Kontrollera anslutningen innan du skickar in arbete

Bekräfta att alla sex verktyg som listas nedan upptäcks. En klient kan lägga till ett eget prefix till verktygsnamnen. Upptäckt bekräftar en anslutning, inte en lyckad verifiering.

Med OAuth eller en Live-API-nyckel: ge behörighet till saldot och be först agenten att anropa fairvalid_get_balance utan argument. Att läsa saldot förbrukar inga verifieringskrediter. Skicka inte sandlådeexemplen via en liveanslutning.

Med en Test-API-nyckel följer du i stället sandlådekontrollen nedan. Liveverifiering kan reservera och förbruka krediter – välj en adress som du har behörighet att kontrollera och begär inskickningen uttryckligen.

Om en anslutning misslyckas, kontrollera kontots behörigheter för anslutningar, slutpunkten, saknade miljövariabler samt om nyckeln eller behörigheten har återkallats. Vid fel som gäller behörighet eller utgiftstak, granska beviljade behörigheter eller taket innan du försöker igen; en ny idempotensnyckel åtgärdar inte orsaken.

Börja med en gratis kontroll i sandlådan

Använd en fv_test_-nyckel och anropa fairvalid_verify_email med exemplet nedan. Kontrollen av en enskild adress med testnyckel returnerar ett simulerat resultat direkt. Den gör inget anrop till leverantören, skapar ingen live-verifiering och använder inga krediter.

Andra reserverade exempel är undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com och error@example.com. Pending och error är avsiktliga simuleringar, inte riktiga brevlådekontroller. Exemplet med väntande enskild adress har inget jobb att avfråga.

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

Verktyg och behörigheter

fairvalid_verify_email tar email och idempotency_key. fairvalid_submit_job tar emails, idempotency_key och ett valfritt name, för 1 till 5 000 adresser. Inskickningar i live-läge kräver behörigheten submit.

fairvalid_get_job tar job_id för att läsa status. fairvalid_get_results tar job_id och valfria cursor, filter och search för att läsa upp till 50 resultat åt gången. Läsningar i live-läge kräver behörigheten read.

fairvalid_cancel_job tar job_id och begär avbrytning; kontroller som redan pågår kan slutföras. Avbrytning i live-läge kräver behörigheten submit. fairvalid_get_balance tar inga argument och kräver en live-nyckel med behörigheten balance. Testnycklar kan inte läsa ett live-kreditsaldo.

Nycklarna avgör arbetsytan. Verktygen tar inte emot något argument för API-nyckel eller arbetsyta. Behörighetskontroller, återkallelse, utgiftstak och arbetsytans kreditregler gäller för MCP precis som för kund-API:et.

Följ ett pågående jobb fram till resultaten

Med OAuth eller en fv_live_-nyckel skickar både enskild verifiering och massverifiering in asynkrona jobb. Ett accepterat svar och ett job_id betyder att arbetet har tagits emot, inte att kontrollen av brevlådan är klar. Behandlingstiden beror på kön och verifieringsleverantören.

För en sandlådeövning av jobbflödet anropar du fairvalid_submit_job med reserverade exempeladresser. Sandlådejobb stödjer status, resultat, avbrytning och omspelning utan anrop till leverantörer eller kreditanvändning.

1. Skicka en gång med en stabil idempotency_key och spara det returnerade job_id.
2. Anropa fairvalid_get_job med det job_id:t. Sprid ut pollningsanropen och backa av vid tillfälliga fel.
3. Anropa fairvalid_get_results med samma job_id. Skicka tillbaka varje next_cursor som cursor tills next_cursor är null. En cursor behåller det ursprungliga filtret och sökningen.
4. Kontrollera både jobbstatusen och varje resultat. Utfallen okänd, catch-all och kontrolleras fortfarande är inte bevis på att en brevlåda är giltig.

Försök igen utan att skapa dubbelt arbete

Båda inskickningsverktygen kräver en idempotency_key på 8 till 128 bokstäver, siffror, punkter, kolon, understreck eller bindestreck. Försök igen vid ett osäkert svar med samma API-nyckel eller OAuth-anslutning, samma idempotency_key och oförändrad indata. Återuppspelning är knuten till den underliggande API-nyckeln: om en OAuth-åtkomsttoken roteras behålls identiteten, men om du väljer en annan API-nyckel och skickar in igen kan en ny körning skapas. En ändrad jobbnyttolast med en befintlig idempotensnyckel avvisas. Använd en ny idempotensnyckel endast när du avsiktligt vill starta en ny körning.

Kontrollera isError innan du läser resultatet. Anrop som når kund-API:et inkluderar dess svar och HTTP-status i structuredContent; fel vid argumentvalidering kan returnera enbart textinnehåll. Granska ett API-fels code och följ eventuella tips om nya försök. En timeout eller ett tillfälligt fel bevisar inte att den ursprungliga inskickningen saknades.

Live-nycklar kan förbruka arbetsytans krediter. Ange ett totalt tak innan du ansluter en autonom agent: både debiterade och reserverade krediter räknas. Slutförda giltiga och ogiltiga kontroller förbrukar en kredit; okända resultat, olösta catch-all-resultat och tekniska fel förbrukar i slutändan ingen kredit för verifiering.