அத்தியாயம் 18: @seameet/mcp CLI-ஐ இணைத்தல்

@seameet/mcp CLI என்பது, மற்ற கருவிகள் (Claude Desktop, IDE-கள், முகவர்கள்) உங்கள் SeaMeet கணக்கிலிருந்து படிக்கவும் எழுதவும் உதவும், headless ஒரு Model Context Protocol சர்வர். இது headless என்பதால், இதை device-authorization ஓட்டம் (RFC 8628) மூலமே ஒப்புக்கொள்ள வேண்டும் — CLI உங்களுக்கு ஒரு சிறு குறியீட்டைக் காட்டும்; நீங்கள் ஒரு URL-ஐப் பார்வையிட்டு, குறியீட்டை உறுதிப்படுத்தினால் முடிந்தது.

இந்த அத்தியாயம் வலை-ஆப் பக்கத்தை உள்ளடக்குகிறது: /link பக்கம், ஒப்புதல் செயல், பாதுகாப்புத் தடைகள்.

ஓட்டம், தொடக்கம் முதல் முடிவு வரை

CLI-ஐ இயக்குங்கள் (உதா. npx @seameet/mcp அல்லது அதைத் தூண்டும் ஒரு client).
CLI ஒரு சிறு குறியீட்டையும் URL-ஐயும் அச்சிடும் — பொதுவாக app.seameet.ai/link மற்றும் ABCD-EFGH போன்ற ஒரு குறியீடு.
URL-ஐ உங்கள் உலாவியில் திறங்கள்.
/link பக்கத்தில் குறியீட்டை உள்ளிடுங்கள் (அல்லது CLI query string வழியாக முன்பே நிரப்பியிருக்கலாம்).
Approve என்பதைக் கிளிக் செய்யுங்கள்.
CLI, உங்கள் சார்பில் ஒரு read+write API விசையைப் பெறும்; இப்போது செயல்பட முடியும்.

அவ்வளவே. முழு ஓட்டமும் வழக்கமாக 30 வினாடிகளுக்கும் குறைவாக எடுக்கும்.

"உங்கள் சார்பில்" என்பதன் அர்த்தம்

/link வழங்கும் API விசை, உங்கள் SeaMeet கணக்கிற்கு வரம்புக்குட்பட்ட ஒரு உண்மையான பயனர்-வாரி டோக்கன். CLI அதைக் கொண்டு செய்யும் எதுவும், உங்கள் செயலாகவே உங்கள் நூலகத்தில் தோன்றும். குறிப்பாக:

Read — CLI உங்கள் பதிவுகளைப் பட்டியலிடலாம், ஒலிப்பெயர்ப்புகள் மற்றும் சுருக்கங்களை மீட்டெடுக்கலாம், உங்கள் காப்பகம் முழுவதும் Meeting Memory-ஐ விசாரிக்கலாம்.
Write — CLI பதிவுகளை (பதிவேற்றம் மூலம்) உருவாக்கலாம், தலைப்புகள் மற்றும் விளக்கங்களைப் புதுப்பிக்கலாம், பகிர்வுகளை உருவாக்கலாம்; பொதுவாக உங்கள் சாதாரண அமர்வு செய்யக்கூடியதையெல்லாம் செய்யலாம்.

டோக்கன் உங்கள் கணக்குடன் பிணைக்கப்பட்டிருந்தாலும், உங்கள் அமர்வைத் திரும்பப் பெறுவது (எங்கும் வெளியேறுதல்) CLI-இன் டோக்கனைத் திரும்பப் பெறாது — அந்த டோக்கன் ஒரு தனி அறிவிப்புச் சான்று. கீழே "CLI ஒப்புதலைத் திரும்பப் பெறுதல்" பார்க்கவும்.

உள்நுழைவு தேவை

/link பக்கம் உண்மையான, சரிபாக்கப்பட்ட, உள்நுழைந்த ஒரு கணக்கைக் கோரும். அதாவது:

வெளியேறியிருந்தால். பக்கம், குறியீட்டைச் சுமக்கும் ஒரு returnTo அளவுருவுடன் உங்களை /signin-க்கு மறுவழிசெலுத்தும்; உள்நுழைந்த பிறகு, குறியீடு அப்படியே இருக்கும்படி ஓட்டம் /link-இல் தொடரும்.
பெயரற்ற guest அமர்வு. வெளியேறியது போலவே — guest அமர்வால் CLI-யை ஒப்புக்கொள்ள முடியாது; CLI-க்கு பிணைக்க ஒரு உண்மையான அடையாளம் தேவை. அமர்வை உண்மையான கணக்காக மேம்படுத்த /signin-க்கு அனுப்பப்படுவீர்கள்.
உள்நுழைந்து சரிபாக்கப்பட்டால். Approve செயல் இயக்கப்படும்.

இது ஒரு வேண்டுமென்றே வைக்கப்பட்ட பாதுகாப்புத் தடை. இது இல்லாவிட்டால், எந்த மனிதரும் வேண்டுமென்றே திறக்காத ஒரு தற்காலிக பெயரற்ற அமர்வின் "சார்பில்" ஒரு CLI செயல்பட முடியும்.

வெளிப்படையான click-to-approve

/link பக்கம் ஒருபோதும் தானாக அங்கீகரிப்பதில்லை. ?code=<value> மூலம் குறியீடு முன்பே நிரப்பப்பட்டிருந்தாலும், நீங்கள் வெளிப்படையாக Approve-ஐக் கிளிக் செய்ய வேண்டும். இது பாதுகாப்பு: load-இல் தானியங்கி ஒப்புதல் ஒரு phishing வழி — தீமை விரும்பும் ஒரு பக்கம், உங்கள் உலாவியில் /link?code=<attacker's-code>-ஐத் திறந்து, நீங்கள் கவனிக்கும் முன்பே தாக்குபவருக்கு ஒரு டோக்கனை உருவாக்கிவிடக்கூடும்.

Approve அழுத்துவதற்கு முன்பே, பக்கத்தில் காட்டப்படும் குறியீடு, உங்கள் CLI காட்டும் குறியீட்டுடன் பொருந்துகிறதா என்று எப்போதும் சரிபார்க்கவும். பொருந்தவில்லை என்றால் பக்கத்தை மூடுங்கள்.

Approve செயல்

Approve-ஐக் கிளிக் செய்தால்:

வலை ஆப், SeaMeet-இன் சர்வர்களுடன் குறியீட்டைச் சரிபார்க்கும்.
சர்வர், குறியீடு செல்லுபடியானதா, காலாவதியாகவில்லையா, ஒரு உண்மையான (பெயரற்றதல்லாத) கணக்குடன் பிணைக்கப்பட்டுள்ளதா என்று சரிபார்க்கும்.
செல்லுபடியானால், ஒரு API விசையை உருவாக்கி, அதைக் குறியீட்டுடன் இணைத்து, வெற்றி என்று திருப்பி அனுப்பும்.
டோக்கன் endpoint-ஐ கண்காணித்துக்கொண்டிருக்கும் CLI, விசையைப் பெற்று ஒரு வெற்றிச் செய்தியை அச்சிடும்.
வலை ஆப்பின் /link பக்கம் "Approved" என்று காட்டும் — தாவலை மூடலாம்.

குறியீடு காலாவதியாகி இருந்தால் (RFC 8628 குறியீடுகள் குறுகிய காலமே — வழக்கமாக 15 நிமிடங்கள்), CLI ஒரு புதியதை உருவாக்கி மீண்டும் தொடங்க வேண்டும்.

CLI ஒப்புதலைத் திரும்பப் பெறுதல்

இரண்டு வழிகள்:

CLI பக்கத்திலிருந்து. CLI-இன் உள்ளூர் சேமிப்பகத்தில் டோக்கனை நீக்குங்கள் (அல்லது CLI வழங்குகிறதென்றால் அதன் logout கட்டளையை இயக்குங்கள்). சர்வர்-பக்கத்திலும் திரும்பப் பெறும் வரை டோக்கன் செல்லுபடியாகவே இருக்கும்.
கணக்கு பக்கத்திலிருந்து. Account → Connected apps → கடைசி-பயன்பாட்டு நேரத்தால் CLI ஒப்புதலைக் கண்டறிந்து → Revoke. இது டோக்கனை சர்வர்-பக்கத்தில் உடனடியாகச் செல்லாததாக்கும்.

மிகுந்த எச்சரிக்கை விரும்புவோருக்கு: சர்வர்-பக்கத்தில் திரும்பப் பெறுங்கள். CLI-பக்க நீக்கம், நடப்பு CLI process-ஐ டோக்கனைப் பயன்படுத்துவதை நிறுத்தும்; ஆனால் டோக்கனின் ஒரு நகல் வேறு இடத்தில் பயன்படுத்தப்படுவதைத் தடுக்காது.

பல CLI ஒப்புதல்கள்

CLI-யைப் பல முறை ஒப்புக்கொள்ளலாம் (உதா. அதைப் பயன்படுத்தும் ஒவ்வொரு கணினிக்கும் ஒரு முறை). ஒவ்வொரு ஒப்புதலும் ஒரு தனி API விசையை உருவாக்கும். Account → Connected apps, ஒவ்வொரு விசையின் metadata-வுடனும் (கடைசியாகப் பயன்படுத்தியது, முதலில் ஒப்புதல்) அவற்றைப் பட்டியலிடும்.

ஒரு CLI ஒப்புதலைத் திரும்பப் பெறுவது, மற்றவற்றைப் பாதிக்காது.

டோக்கன் பாதுகாப்பு

டோக்கன், CLI-இன் உள்ளூர் config அடைவில், இயல்புநிலையாக குறியாக்கமின்றி (unencrypted) சேமிக்கப்படும்.
உங்கள் கணினி கம்ப்ரமைஸ் ஆனால், டோக்கனும் கம்ப்ரமைஸ் ஆனது. சர்வர்-பக்கத்தில் திரும்பப் பெற்று, மீண்டும் ஒப்புக்கொள்ளுங்கள்.
டோக்கன் இயல்புநிலையில் காலாவதி இல்லாதது (நீண்டகாலம்). குறுகிய கால டோக்கன்களை விரும்பினால், உங்கள் சுழற்சி அட்டவணைக்கேற்ப திரும்பப் பெற்று மீண்டும் ஒப்புக்கொள்ளுங்கள்.
டோக்கன்கள் HTTPS வழியாகவே அனுப்பப்படும் (HSTS-ஆல் பாதுகாக்கப்பட்டது — அத்தியாயம் 17-ஐப் பார்க்கவும்).

Entitlement தொடர்தல்

CLI நீங்களாகவே செயல்படும் — எனவே அதற்கு உங்கள் entitlement நிலையே. நீங்கள் இலவசத் திட்டத்தில் இருந்தால், ஒலிப்பெயர்ப்புகளைப் படிக்கும்போது CLI-யும் இலவசத் திட்ட வெளிப்படுத்தல் வரம்புக்கு உட்படும். Sync Pro? CLI-க்கு முழு read.

பதிவுகளை உருவாக்குதல் போன்ற write செயல்கள், ஒரு சாதாரண அமர்வு எவ்வாறு எண்ணப்படுமோ அவ்வாறே உங்கள் quotas-க்கு எதிராக எண்ணப்படும்.

சாதாரண பிரச்சனைகள்

"குறியீடு காலாவதியானது." குறியீடுகள் குறுகிய காலமே (வழக்கமாக 15 நிமிடங்கள்). புதியதொன்றைப் பெற CLI-ஐ மறுதொடக்கம் செய்யுங்கள்.

"குறியீடு ஒப்புதல் ஆனது; ஆனால் CLI கவனிக்கவில்லை." CLI சில வினாடிகளுக்கு ஒருமுறை டோக்கன் endpoint-ஐ கண்காணிக்கும். 10-15 வினாடிகள் கொடுங்கள். இன்னும் எதுவும் இல்லை என்றால் CLI-ஐ மறுதொடக்கம் செய்யுங்கள் — polling loop செயலிழந்திருக்கலாம்.

"உள்நுழைந்தேன்; ஆனால் குறியீடு இழந்தேன்." /link பக்கம் குறியீட்டை returnTo-இல் சுமக்கும் — உள்நுழைந்தால், குறியீடு பாதுகாக்கப்பட்ட நிலையில் திரும்புவீர்கள். ஏதோ காரணத்தால் இழந்திருந்தால், புதிய குறியீட்டுக்கு CLI-ஐ மறுதொடக்கம் செய்யுங்கள்.

"Approve 'not_entitled' பிழையைத் திருப்புகிறது." கணக்கின் entitlement-இல் CLI ஒப்புதல் இல்லை — தற்போது CLI ஒப்புதலுக்கு Sync Pro தேவை. மேம்பட்டு மீண்டும் முயற்சிக்கவும்.

"ஒப்புதல் கொடுத்தேன்; ஆனால் என் CLI இன்னும் 'authorization required' என்கிறது." CLI-இன் config அடைவில் சேமிக்கப்பட்ட டோக்கனைச் சரிபார்க்கவும் (பாதை CLI பதிப்பைப் பொறுத்தது). வெறுமையாக இருந்தால், CLI டோக்கனைத் தவறவிட்டது — மறுதொடக்கம் செய்து மீண்டும் ஒப்புக்கொள்ளுங்கள்.

விரைவுக் குறிப்பு

பணி	எப்படி
CLI குறியீட்டை ஒப்புக்கொள்	`app.seameet.ai/link` → குறியீட்டை உள்ளிடு/சரிபார் → Approve
CLI டோக்கனைத் திரும்பப் பெறு (சர்வர் பக்கம்)	Account → Connected apps → Revoke
CLI டோக்கனைத் திரும்பப் பெறு (client பக்கம்)	CLI-இன் `logout` கட்டளை, அல்லது CLI config கோப்பை நீக்கு
அனைத்து ஒப்புதல்களையும் பார்	Account → Connected apps
பல கணினிகளில் ஒப்புக்கொள்	ஒவ்வொரு கணினிக்கும் ஒரு முறை — ஒவ்வொன்றும் ஒரு தனி டோக்கனை உருவாக்கும்

கடைசியாகப் புதுப்பிக்கப்பட்டது: 2026-08-28

← அத்தியாயம் 17: கணக்கு மற்றும் அமைப்புகள்