AI Drive MCP சேவையகம்
Claude Desktop போன்ற வெளி MCP கிளையண்டுகளிலிருந்து Keural இயக்ககத்தின் ஆவணங்களைத் தேடி வாசிக்கவும்.
Keural இயக்ககத்தை MCP சேவையகமாகவும் வழங்குகிறது. வெளி MCP கிளையண்ட் இணைந்தால், சாவியைப் பெற்ற பயனர் பார்க்க முடிந்த இயக்கக ஆவணங்களைத் தேடலாம்; பக்கம் பக்கமாக வாசிக்கலாம். செருகுநிரல்கள் வெளி அமைப்பை Keural உடன் இணைக்கும்; இந்தச் சேவையகம் Keural ஆவணங்களை வெளி AI உடன் இணைக்கிறது.
இந்தச் சேவையகம் நிறுவன API சாவியால் அங்கீகரிக்கப்படுகிறது. நிறுவன API சாவியை Keural செயல்பாட்டுக் குழு வழங்கும், எனவே செயல்படுத்தும் பொறுப்பாளரிடம் கேளுங்கள். சாவி அதைப் பெற்ற ஒரு பயனரின் அனுமதியின் கீழ் இயங்கும்; drive:read அனுமதி இருக்க வேண்டும். சாவியைத் திரும்பப் பெற்றால், ஏற்கனவே உள்ள இணைப்புகளும் அதிகபட்சம் 1 நிமிடத்துக்குள் தடுக்கப்படும்.
இணைப்புத் தகவல்
| உருப்படி | மதிப்பு |
|---|---|
| போக்குவரத்து முறை | MCP Streamable HTTP |
| முகவரி | https://<agent server domain for each environment>/core/v1/mcp-drive |
| அங்கீகாரம் | Authorization: Bearer <organization API key> (எல்லாக் கோரிக்கைகளுக்கும்) |
கோரிக்கை முறை
| முறை | பயன்பாடு |
|---|---|
POST | ஒரு JSON-RPC கோரிக்கை. பதில் எப்போதும் ஒரு application/json. அறிவிப்புகள் (notifications/*) உடல் இல்லாமல் 202 ஐத் திருப்பும். |
GET | சேவையக நிகழ்வு ஓடை. Accept: text/event-stream மற்றும் Mcp-Session-Id தேவை. ஒவ்வொரு 15 வினாடிக்கும் keepalive அனுப்பும்; Last-Event-ID மூலம் தொடர்ந்து பெறலாம். |
DELETE | அமர்வை முடிக்கும். Mcp-Session-Id தேவை; 204 ஐத் திருப்பும். |
initializeவெற்றியடைந்தால், பதில் தலைப்புMcp-Session-Idஇல் அமர்வு ID திருப்பி அனுப்பப்படும். அமர்வு விருப்பத்தேர்வு; அமர்வு இல்லாமல்POSTமட்டும் அனுப்பலாம். கடைசிக் கோரிக்கைக்குப் பின் 1 மணி நேரம் அமர்வு நீடிக்கும்; அதை உருவாக்கிய சாவியுடன் பிணைக்கப்பட்டிருக்கும்.MCP-Protocol-Versionதலைப்பை அனுப்பினால் மதிப்பு2025-06-18ஆக இருக்க வேண்டும். அனுப்பாமலும் இருக்கலாம்.- சேவையகத் தகவல்
keural-ai-drive; வழங்கும் வசதிtoolsமட்டுமே.
HTTP பிழைகள்
HTTP நிலையில் ஏற்படும் பிழைகள் JSON-RPC வடிவில் இருக்காது; எனவே முதலில் நிலைக் குறியீட்டைச் சரிபார்க்கவும்.
| நிலை | காரணம் |
|---|---|
401 | சாவி இல்லை அல்லது தவறு; திரும்பப் பெற்ற அல்லது காலாவதியான சாவி |
403 | சாவிக்கு drive:read அனுமதி இல்லை |
400 | ஆதரிக்கப்படாத MCP-Protocol-Version, JSON பகுப்பாய்வு தோல்வி (-32700), அமர்வு ID இல்லாமல் GET அல்லது DELETE |
404 | தெரியாத அல்லது காலாவதியான அமர்வு ID |
405 | Accept: text/event-stream இல்லாமல் GET |
JSON-RPC நிலைப் பிழைகள் 200 உடன் error ஆகத் திருப்பப்படும். தெரியாத முறை அல்லது கருவி -32601; தவறான கோரிக்கை வடிவம் -32600.
கருவிகள்
| கருவி | உள்ளீடு | விளக்கம் |
|---|---|---|
list_files | இல்லை | நீங்கள் பார்க்கக்கூடிய ஆவணப் பட்டியல் (பெயர், id, பதிவேற்றிய தேதி, திருத்திய தேதி, வேறொருவர் பதிவேற்றியிருந்தால் பதிவேற்றியவர்). இயக்கக ஆவணங்களும் அரட்டையில் இணைத்த கோப்புகளும் சேர்ந்து வரும்; origin மூலம் வேறுபடுத்தப்படும். அதிகபட்சம் 500; தாண்டினால் truncated: true சேர்க்கப்படும் |
search_drive | query | ஆவண உள்ளடக்கத்தை பொருள் அடிப்படையில் தேடி, தொடர்புடைய பகுதிகளையும் மேற்கோள் தகவலையும் திருப்பி அனுப்பும் |
read_document_page | file_id, page | ஆவணத்தின் குறிப்பிட்ட பக்கத்தின் முழு உரையை வாசிக்கும். file_id மேலுள்ள இரண்டு கருவிகளின் முடிவிலிருந்து எடுக்கப்படும்; page 1 இலிருந்து எண்ணப்படும் |
கருவியின் முடிவு content[0].text இல் JSON சரமாக இருக்கும்.
| கருவி | text இல் உள்ள JSON |
|---|---|
list_files | {"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}. தேதி yyyy-MM-dd HH:mm வடிவில் |
search_drive | {"sources":[{"id","name","url","contents":[…]}]} |
read_document_page | {"file_id","page","rows":[…]} |
கருவி இயக்கம் தோல்வியடைந்தால் JSON-RPC பிழை அல்ல; isError: true மற்றும் {"error": "…"} திருப்பி அனுப்பப்படும். பார்க்க முடியாத அல்லது இல்லாத ஆவணங்கள் அனைத்தும் file not found or not accessible என்றே பதிலளிக்கும்.
கிளையண்ட் அமைப்பு எடுத்துக்காட்டு
தொலைநிலை MCP சேவையகத்தை ஆதரிக்கும் கிளையண்டில் முகவரியையும் தலைப்பையும் பதிவு செய்யவும். கீழே உள்ளது வடிவ எடுத்துக்காட்டு மட்டுமே. அமைப்பு வடிவம் கிளையண்டுக்குக் கிளையண்ட் மாறுபடும்; நீங்கள் பயன்படுத்தும் கிளையண்டின் தொலைநிலை MCP சேவையகச் சேர்ப்பு முறையைப் பின்பற்றவும்.
{
"mcpServers": {
"keural-drive": {
"type": "http",
"url": "https://<சூழலுக்கான_முகவர்_சேவையக_டொமைன்>/core/v1/mcp-drive",
"headers": { "Authorization": "Bearer <நிறுவன_API_சாவி>" }
}
}
}ஆதரிக்கப்படும் MCP நெறிமுறை பதிப்பு 2025-06-18.