MCP দিয়ে একটি AI এজেন্ট সংযুক্ত করুন

আপনার ক্লায়েন্ট বেছে নিন

এন্ডপয়েন্ট: https://mcp.fairvalid.com/mcp। ট্রান্সপোর্ট: Streamable HTTP।

API কী বা OAuth সাইন-ইন দিয়ে সংযুক্ত করুন। যোগ্য ChatGPT, Claude ও Grok সংযোগে OAuth ব্যবহার করা যায়; নিচে আপনার ক্লায়েন্টের অ্যাকাউন্ট ও রোলের শর্তাবলি দেখুন। Codex, Claude Code ও Hermes সরাসরি API কী দিয়েও সংযোগ সমর্থন করে।

API-key ক্লায়েন্টের জন্য, ওয়ার্কস্পেসের Owner বা Manager হিসেবে API কী-এ একটি লেবেলযুক্ত Test key তৈরি করুন। এটি ক্লায়েন্টের সুরক্ষিত ক্রেডেনশিয়াল বা নির্ধারিত এনভায়রনমেন্ট সেটিংসে সংরক্ষণ করুন। কখনোই কোনো কী প্রম্পট, টুল আর্গুমেন্ট, URL বা কমিট করা কনফিগারেশনে রাখবেন না।

OAuth প্রক্রিয়া সাইন-ইন ও সম্মতির জন্য fairvalid.com খোলে। অনুরোধকৃত অনুমতিগুলো কভার করে এমন একটি বিদ্যমান Live API কী আপনি বেছে নেবেন এবং এর ওয়ার্কস্পেস ও আজীবন সীমা পর্যালোচনা করবেন। অনুমোদন দিলে অনুরোধকৃত সব অনুমতি একসাথে দেওয়া হয়, তবে সেই কী-এর স্কোপের মধ্যে। এতে AI ক্লায়েন্টে সেই কী পেস্ট করতে বলা হয় না। নির্বাচিত কী বাতিল করলে এর সংযোগগুলোও বন্ধ হয়ে যায়। OAuth লাইভ কী ব্যবহার করে; স্যান্ডবক্সের জন্য সরাসরি Test-কী সংযোগ ব্যবহার করুন।

ক্লায়েন্ট নির্দেশনাগুলো 23 অক্টোবর 2026-এ পর্যালোচনা করা হয়েছে। হোস্টেড MCP প্রোটোকলটি অফিশিয়াল SDK-সহ প্রোডাকশন গ্রহণযোগ্যতা যাচাইয়ে উত্তীর্ণ হয়েছে। এর অর্থ এই নয় যে উল্লিখিত প্রতিটি ক্লায়েন্ট পরীক্ষা করা হয়েছে; এর ওপর নির্ভর করার আগে আপনার ক্লায়েন্টে সংযোগ যাচাই সম্পন্ন করুন।

ChatGPT

নিচের OAuth সেটআপ ব্যবহার করুন। বর্তমান কাস্টম MCP সংযোগের জন্য ওয়েবে ChatGPT Business বা Enterprise/Edu প্রয়োজন, সাথে MCP-সহ প্লাগইন তৈরির অনুমতি। Business-এ একজন অ্যাডমিন বা ওনার প্রয়োজন; Enterprise/Edu নির্বাচিত সদস্যদের অনুমোদন দিতে পারে।

1. Plugins খুলুন, প্লাস বোতামটি নির্বাচন করুন, তারপর Add custom MCP server বেছে নিন। বর্তমান Plugins প্রক্রিয়ায় Developer Mode প্রয়োজন হয় না।
2. সংযোগের নাম FairValid দিন এবং পাবলিক HTTPS এন্ডপয়েন্ট হিসেবে https://mcp.fairvalid.com/mcp লিখুন।
3. স্বয়ংক্রিয় ক্লায়েন্ট রেজিস্ট্রেশনসহ OAuth বেছে নিন। FairValid পাবলিক ক্লায়েন্ট রেজিস্ট্রেশন ব্যবহার করে: আপনাকে কোনো client ID বা client secret দিতে হবে না। কোনো ঘরেই কখনো API কী লিখবেন না।
4. ওপরে বর্ণিত FairValid সাইন-ইন ও সম্মতি সম্পন্ন করুন। ChatGPT-এর সতর্কবার্তা পর্যালোচনা করুন, তারপর Create as a plugin নির্বাচন করুন এবং খুঁজে পাওয়া ছয়টি টুল পরীক্ষা করুন।
5. প্লাগইনটি ইনস্টল করুন, নতুন কথোপকথন খুলুন, @ টাইপ করে FairValid নির্বাচন করুন। লাইভ যাচাইয়ের অনুরোধ করার আগে নিচের শুধু-পঠনযোগ্য সংযোগ পরীক্ষাটি চালান।

অফিসিয়াল ডকুমেন্টেশন: OpenAI: একটি কাস্টম MCP সার্ভার সংযুক্ত করুন · OpenAI: OAuth প্রমাণীকরণ

Claude ওয়েব ও ডেস্কটপ

OAuth সহ একটি রিমোট কাস্টম কানেক্টর ব্যবহার করুন। Claude ওয়েব ও Desktop-এ এটি একই অ্যাকাউন্ট-ভিত্তিক সংযোগ; এটি Anthropic-এর সার্ভারের মাধ্যমে চলে। Team ও Enterprise-এ প্রথমে প্রতিষ্ঠানের একজন Owner কানেক্টরটি যোগ করেন। প্রতিষ্ঠানের লাইব্রেরি পরিচালনার কাস্টম ভূমিকাসম্পন্ন Enterprise সদস্যরাও এটি যোগ করতে পারেন।

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. Customize → Connectors → Add custom connector খুলুন। পরিচালিত প্রতিষ্ঠানের ক্ষেত্রে একজন Owner বা যোগ্য Enterprise রোলধারী Organization settings → Connectors → Add → Custom → Web থেকে শুরু করবেন।
2. FairValid এবং https://mcp.fairvalid.com/mcp লিখুন।
3. Sign in now বেছে নিন। OAuth ক্লায়েন্ট বেছে নেওয়ার বিকল্প দেখা গেলে Register automatically নির্বাচন করুন। ম্যানুয়ালি রেজিস্টার করা client ID ও secret-এর ঘরগুলো ফাঁকা রাখুন।
4. fairvalid.com-এ সাইন ইন করুন, নির্বাচিত লাইভ কী ও অনুমতিগুলো পর্যালোচনা করুন এবং সংযোগটি অনুমোদন করুন। কথোপকথনের connector নিয়ন্ত্রণ থেকে FairValid চালু করুন।
5. নিচের রিড-অনলি সংযোগ যাচাইটি চালান। Request headers-এর মাধ্যমে টেস্ট API কী দিয়ে সংযুক্ত হলে তবেই স্যান্ডবক্স যাচাইটি ব্যবহার করুন।

অফিসিয়াল ডকুমেন্টেশন: Anthropic: কাস্টম কানেক্টর ও অথেনটিকেশন · Anthropic: রিমোট কানেক্টরের প্রাপ্যতা

Claude Code

Claude Code সরাসরি API কী দিয়ে সংযোগ সমর্থন করে। যে এনভায়রনমেন্ট থেকে Claude Code চালু হয় সেখানে FAIRVALID_API_KEY সেট করুন এবং প্রথম যাচাইয়ের জন্য একটি Test কী ব্যবহার করুন। আসল সিক্রেটটি প্রজেক্ট ফাইলের বাইরে রাখুন।

1. নিচের কনফিগারেশনটি প্রজেক্টের .mcp.json-এ যুক্ত করুন। বিদ্যমান সার্ভারগুলো রেখে দিন। ফাইলে আক্ষরিক এনভায়রনমেন্ট রেফারেন্সটি থাকবে; কী-এর মান নয়।
2. FAIRVALID_API_KEY উপলব্ধ রেখে Claude Code চালু করুন। অনুরোধ করা হলে প্রজেক্টের MCP কনফিগারেশন অনুমোদন করুন।
3. claude mcp list চালান, তারপর সেশনে /mcp দেখুন। FairValid সংযুক্ত হয়েছে এবং ছয়টি টুল দেখাচ্ছে কি না নিশ্চিত করুন, তারপর নিচের স্যান্ডবক্স যাচাইটি করুন।

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

অফিসিয়াল ডকুমেন্টেশন: Anthropic: Claude Code MCP কনফিগারেশন

Hermes Agent

এই নির্দেশনাগুলো NousResearch Hermes Agent-এর জন্য। এর রিমোট HTTP ট্রান্সপোর্ট bearer হেডার সমর্থন করে। CLI আপনার সক্রিয় প্রোফাইলের .env-এ MCP_FAIRVALID_API_KEY হিসেবে কী সংরক্ষণ করে এবং config.yaml-এ একটি এনভায়রনমেন্ট রেফারেন্স রাখে।

1. নিচের add কমান্ডটি চালান। অথেন্টিকেশন প্রয়োজন কি না জিজ্ঞেস করলে yes দিন, তারপর মাস্ক করা API key / Bearer token প্রম্পটে একটি টেস্ট API কী লিখুন।
2. খুঁজে পাওয়া টুলগুলো পর্যালোচনা করুন এবং আপনার প্রয়োজনীয় FairValid টুলগুলো চালু করুন। সেটআপটি সফলভাবে সংযুক্ত হতে হবে; কোনো ত্রুটির পরে নিষ্ক্রিয় সংযোগ সংরক্ষণ করলে তা সফল সেটআপ হিসেবে গণ্য হয় না।
3. hermes mcp test fairvalid চালান, তারপর একটি নতুন সেশন শুরু করুন অথবা /reload-mcp চালান। নিচের স্যান্ডবক্স যাচাইটি করুন। Hermes টুলের নামের আগে তার সার্ভার-নামের প্রিফিক্স যোগ করতে পারে।

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

hermes mcp test fairvalid

অফিসিয়াল ডকুমেন্টেশন: NousResearch: MCP কনফিগারেশন · NousResearch: MCP সংযোগ যাচাই · NousResearch: হেডার-অথ CLI ইমপ্লিমেন্টেশন

Grok Bot ও Grok

Grok Bot ও Grok.com-এর সেটআপের জায়গা আলাদা। ব্যক্তিগত Grok Bot-এ, নিচের অনুরোধটি ব্যবহার করে Bot-কে FairValid যোগ করতে বলুন। ইনফো প্যানে শুধু Details, Library ও Computer দেখালে এবং কোনো Setup অংশ না থাকলেও এই পদ্ধতি কাজ করে।

Team Bot-এর ক্ষেত্রে বটের মালিক বা ম্যানেজারদের জন্য অতিরিক্তভাবে info pane → Setup → Plugins দেখানো হয়। এই সেটআপ অংশের জন্য ডেস্কটপ অ্যাপে Team Bot অ্যাক্সেস প্রয়োজন। OAuth ব্যবহার করা হলে প্রত্যেক সহকর্মী নিজের অ্যাকাউন্ট দিয়ে সাইন ইন করেন।

Grok.com-এ grok.com/connectors → New Connector → Custom ব্যবহার করুন। https://mcp.fairvalid.com/mcp লিখুন এবং অথেনটিকেশন সম্পন্ন করুন। Business ও Enterprise টিমের ক্ষেত্রে প্রথমে তাদের অ্যাডমিনিস্ট্রেটরকে কানেক্টরটি প্রভিশন করতে হতে পারে। এটি Grok Bot প্লাগইন থেকে আলাদা একটি সংযোগ।

xAI API দিয়ে তৈরি বটও আলাদা: এর ডেভেলপার সার্ভার কোডে রিমোট MCP হেডার কনফিগার করেন। এই নির্দেশনায় দাবি করা হয় না যে Grok Bot কোনো সাধারণ Authorization-হেডার ফিল্ড দেয়।

1. নিচের অনুরোধটি ব্যবহার করে আপনার Bot-কে কাস্টম Remote HTTPS MCP সংযোগ যোগ করতে বলুন। Team Bot-এর ক্ষেত্রে এর মালিক বা ম্যানেজার 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. fairvalid.com-এ FairValid-এর সম্মতি প্রক্রিয়া সম্পন্ন করুন। প্রয়োজন হলে প্রত্যেক সহকর্মী নিজের অ্যাকাউন্ট সংযুক্ত করবেন।
4. Bot-কে FairValid-এর টুলগুলোর তালিকা দিতে এবং নিচের শুধু-পড়ার সংযোগ যাচাইটি চালাতে বলুন। শুধু টুল খুঁজে পাওয়া মানেই কোনো যাচাই সম্পন্ন হয়েছে, তা প্রমাণ হয় না।

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.

অফিসিয়াল ডকুমেন্টেশন: xAI: Grok Bot প্লাগইন ও Remote HTTPS · xAI: Grok.com কাস্টম কানেক্টর · xAI: API ডেভেলপারদের জন্য রিমোট MCP

Codex

Codex থেকে সরাসরি API-কী সংযোগ ব্যবহার করুন। Codex প্রসেসের জন্য উপলব্ধ এনভায়রনমেন্টে FAIRVALID_API_KEY সেট করুন, এবং প্রথম যাচাইয়ের জন্য একটি Test কী ব্যবহার করুন। আলাদাভাবে চালু করা ডেস্কটপ অ্যাপ আপনার টার্মিনালের এনভায়রনমেন্ট নাও পেতে পারে।

1. রিমোট Streamable HTTP সার্ভারটি নিবন্ধন করতে নিচের কমান্ডটি চালান। কমান্ডটি API কী নয়, এনভায়রনমেন্ট ভেরিয়েবলের নাম সংরক্ষণ করে।
2. codex mcp list চালান এবং একটি নতুন Codex সেশন শুরু করুন, যাতে এটি সংযোগটি লোড করে। সেশনের MCP টুলগুলোতে FairValid দেখা যাচ্ছে কি না নিশ্চিত করুন।
3. Codex অ্যাপ ব্যবহার করলে ভেরিয়েবলটি এর এক্সিকিউশন হোস্টে উপলব্ধ করুন এবং প্রয়োজনে অ্যাপটি রিস্টার্ট করুন বা নতুন সেশন খুলুন। CLI সেটআপ সফল হয়েছে বলে ইতিমধ্যে চালু থাকা অ্যাপের এনভায়রনমেন্ট বদলে গেছে, এমনটা ধরে নেবেন না।
4. খুঁজে পাওয়া ছয়টি টুল নিশ্চিত করুন এবং নিচের স্যান্ডবক্স যাচাইটি সম্পন্ন করুন।

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

codex mcp list

অফিসিয়াল ডকুমেন্টেশন: OpenAI: Codex MCP কনফিগারেশন

কাজ জমা দেওয়ার আগে সংযোগটি যাচাই করুন

নিচে তালিকাভুক্ত ছয়টি টুলই খুঁজে পাওয়া গেছে কি না নিশ্চিত করুন। কোনো ক্লায়েন্ট টুলের নামের আগে নিজস্ব প্রিফিক্স যোগ করতে পারে। টুল খুঁজে পাওয়া মানে সংযোগ নিশ্চিত হওয়া, সফল যাচাই নয়।

OAuth বা Live API key ব্যবহার করলে ব্যালেন্সের অনুমতি দিন এবং প্রথমে এজেন্টকে কোনো আর্গুমেন্ট ছাড়া fairvalid_get_balance কল করতে বলুন। ব্যালেন্স দেখতে কোনো ভেরিফিকেশন ক্রেডিট খরচ হয় না। লাইভ সংযোগের মাধ্যমে স্যান্ডবক্সের উদাহরণগুলো জমা দেবেন না।

Test API key ব্যবহার করলে এর বদলে নিচের স্যান্ডবক্স যাচাইটি অনুসরণ করুন। লাইভ যাচাইয়ে ক্রেডিট সংরক্ষিত ও খরচ হতে পারে; এমন একটি ঠিকানা বেছে নিন যা যাচাই করার অনুমতি আপনার আছে, এবং স্পষ্টভাবে জমা দেওয়ার অনুরোধ করুন।

সংযোগ ব্যর্থ হলে অ্যাকাউন্টের কানেক্টর অনুমতি, এন্ডপয়েন্ট, অনুপস্থিত এনভায়রনমেন্ট ভেরিয়েবল এবং কী বা অনুমতি প্রত্যাহার হয়েছে কি না তা দেখুন। অনুমতি বা খরচের সীমা-সংক্রান্ত ত্রুটির ক্ষেত্রে আবার চেষ্টা করার আগে প্রদত্ত স্কোপ বা সীমা পর্যালোচনা করুন; নতুন idempotency key দিলে মূল কারণের সমাধান হয় না।

একটি বিনামূল্যের স্যান্ডবক্স যাচাই দিয়ে শুরু করুন

একটি fv_test_ কী ব্যবহার করুন এবং নিচের উদাহরণসহ fairvalid_verify_email কল করুন। টেস্ট-কী দিয়ে একক ঠিকানার যাচাই সরাসরি একটি সিমুলেটেড ফলাফল দেয়। এতে কোনো প্রোভাইডার কল হয় না, কোনো লাইভ যাচাই তৈরি হয় না এবং কোনো ক্রেডিট ব্যবহার হয় না।

অন্যান্য সংরক্ষিত উদাহরণগুলো হলো undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com এবং error@example.com। Pending ও error ইচ্ছাকৃত সিমুলেশন, আসল মেইলবক্স যাচাই নয়। একক-ঠিকানার pending উদাহরণে পোল করার মতো কোনো জব নেই।

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

টুল ও অনুমতি

fairvalid_verify_email email ও idempotency_key নেয়। fairvalid_submit_job ১ থেকে ৫,০০০টি ঠিকানার জন্য emails, idempotency_key এবং একটি ঐচ্ছিক name নেয়। লাইভ সাবমিশনের জন্য submit স্কোপ প্রয়োজন।

fairvalid_get_job অবস্থা পড়ার জন্য job_id নেয়। fairvalid_get_results job_id এবং ঐচ্ছিক cursor, filter ও search নেয়, একবারে সর্বোচ্চ ৫০টি ফলাফল পড়ার জন্য। লাইভ রিডের জন্য read স্কোপ প্রয়োজন।

fairvalid_cancel_job job_id নেয় এবং বাতিলের অনুরোধ করে; চলমান যাচাইগুলো সম্পন্ন হতে পারে। লাইভ বাতিলের জন্য submit স্কোপ প্রয়োজন। fairvalid_get_balance কোনো আর্গুমেন্ট নেয় না এবং এর জন্য balance স্কোপসহ একটি লাইভ কী প্রয়োজন। টেস্ট কী দিয়ে লাইভ ক্রেডিট ব্যালেন্স পড়া যায় না।

কী-ই ওয়ার্কস্পেস নির্ধারণ করে। টুলগুলো কোনো API কী বা ওয়ার্কস্পেস আর্গুমেন্ট গ্রহণ করে না। স্কোপ যাচাই, প্রত্যাহার, খরচের সীমা এবং ওয়ার্কস্পেসের ক্রেডিট নিয়ম কাস্টমার API-এর মতোই MCP-এর ক্ষেত্রেও প্রযোজ্য।

একটি চলমান জব তার ফলাফল পর্যন্ত অনুসরণ করুন

OAuth বা fv_live_ key ব্যবহার করলে একক ও বাল্ক উভয় যাচাই অ্যাসিঙ্ক্রোনাস জব হিসেবে জমা হয়। accepted রেসপন্স ও job_id মানে কাজটি গ্রহণ করা হয়েছে, মেইলবক্স যাচাই শেষ হয়েছে এমন নয়। প্রসেসিংয়ের সময় কিউ ও ভেরিফিকেশন প্রোভাইডারের ওপর নির্ভর করে।

জবের প্রক্রিয়া স্যান্ডবক্সে পরীক্ষা করতে, সংরক্ষিত উদাহরণ ঠিকানা দিয়ে fairvalid_submit_job কল করুন। স্যান্ডবক্স জবে প্রোভাইডার কল বা ক্রেডিট খরচ ছাড়াই স্টেট, ফলাফল, বাতিলকরণ ও রিপ্লে সমর্থিত।

1. একটি স্থির idempotency_key দিয়ে একবার জমা দিন এবং ফেরত পাওয়া job_id সংরক্ষণ করুন।
2. ওই job_id দিয়ে fairvalid_get_job কল করুন। পোলিং অনুরোধগুলোর মধ্যে বিরতি রাখুন এবং সাময়িক ত্রুটির সময় অপেক্ষার সময় বাড়ান।
3. একই job_id দিয়ে fairvalid_get_results কল করুন। next_cursor null না হওয়া পর্যন্ত প্রতিটি next_cursor-কে cursor হিসেবে ফেরত পাঠান। একটি cursor মূল ফিল্টার ও সার্চ ধরে রাখে।
4. জবের অবস্থা ও প্রতিটি ফলাফল—দুটোই দেখে নিন। অজানা, ক্যাচ-অল এবং এখনো যাচাই চলছে এমন ফলাফল কোনো মেইলবক্স বৈধ হওয়ার প্রমাণ নয়।

ডুপ্লিকেট কাজ তৈরি না করে আবার চেষ্টা করুন

দুটি সাবমিশন টুলেই 8 থেকে 128 অক্ষরের একটি idempotency_key লাগবে, যাতে থাকতে পারে অক্ষর, সংখ্যা, ডট, কোলন, আন্ডারস্কোর বা হাইফেন। অনিশ্চিত কোনো রেসপন্সের ক্ষেত্রে একই API key বা OAuth সংযোগ, idempotency_key ও অপরিবর্তিত ইনপুট দিয়ে আবার চেষ্টা করুন। রিপ্লে মূল API key-এর সীমার মধ্যে থাকে: OAuth অ্যাক্সেস টোকেন রোটেট করলে সেই পরিচয় বজায় থাকে, কিন্তু অন্য API key বেছে নিয়ে আবার জমা দিলে আরেকটি রান তৈরি হতে পারে। বিদ্যমান idempotency key দিয়ে পরিবর্তিত জব পেলোড পাঠালে তা প্রত্যাখ্যাত হয়। শুধু ইচ্ছাকৃত নতুন রানের জন্যই নতুন idempotency key ব্যবহার করুন।

ফলাফল পড়ার আগে isError দেখে নিন। যেসব কল কাস্টমার API-তে পৌঁছায়, সেগুলোর structuredContent-এ API-এর রেসপন্স ও HTTP স্ট্যাটাস থাকে; আর্গুমেন্ট যাচাইয়ের ত্রুটিতে শুধু টেক্সট কনটেন্ট ফেরত আসতে পারে। API ত্রুটির code পরীক্ষা করুন এবং পুনরায় চেষ্টার কোনো নির্দেশনা থাকলে তা মেনে চলুন। টাইমআউট বা সাময়িক ত্রুটি হলেও তা প্রমাণ করে না যে মূল সাবমিশনটি পৌঁছায়নি।

লাইভ কী দিয়ে ওয়ার্কস্পেসের ক্রেডিট খরচ করা যায়। কোনো স্বয়ংক্রিয় এজেন্ট সংযুক্ত করার আগে একটি আজীবন সীমা নির্ধারণ করুন: কাটা ও সংরক্ষিত, উভয় ক্রেডিটই গণনায় ধরা হয়। সম্পন্ন বৈধ ও অবৈধ যাচাইয়ে এক ক্রেডিট লাগে; অজানা, অমীমাংসিত ক্যাচ-অল ও কারিগরি ব্যর্থতায় যাচাইয়ের কোনো নিট চার্জ নেই।