Skip to main content

AI ఏజెంట్‌ల కోసం MCP

Model Context Protocol (MCP) అనేది AI అసిస్టెంట్‌లకు సాధనాలు మరియు డేటాకు సురక్షితమైన, నిర్మాణాత్మక యాక్సెస్‌ను ఇవ్వడానికి ఒక ఓపెన్ స్టాండర్డ్. గ్లూ కోడ్ రాయడానికి బదులు, మీరు Claude వంటి ఒక అసిస్టెంట్‌ను ఒక MCP సర్వర్ వద్దకు చూపుతారు, మరియు అది అందుబాటులో ఉన్న సాధనాలను కనుగొని మీ తరఫున వాటిని కాల్ చేయగలదు. imatic ఉత్పత్తులు MCP సర్వర్‌లను బహిర్గతం చేస్తాయి, తద్వారా ఒక ఏజెంట్ నిజమైన పని చేయగలదు — అందుబాటును తనిఖీ చేసి ఒక సమావేశాన్ని బుక్ చేయడం, సర్వే ప్రతిస్పందనలను సమర్పించడం మరియు సారాంశీకరించడం, ఒక లైవ్ పోల్‌ను నడపడం — మీ ఖాతా యొక్క అనుమతులను ఉపయోగించి.

MCP మీకు ఏమి ఇస్తుంది

  • సాధన కనుగొనడం — అసిస్టెంట్ సర్వర్‌ను అది ఏమి చేయగలదో అడుగుతుంది మరియు సాధనాల యొక్క ఒక టైప్డ్ జాబితాను పొందుతుంది, కాబట్టి మీరు ఇంటిగ్రేషన్‌లను చేతితో రాయవలసిన అవసరం లేదు.
  • కేవలం చాట్ కాదు, నిజమైన చర్యలు — సాధనాలు మీ వాస్తవ డేటాను చదువుతాయి మరియు వ్రాస్తాయి (మీరు మంజూరు చేసిన స్కోప్‌లలో).
  • ఒక ప్రోటోకాల్, అనేక ఉత్పత్తులు — అదే కనెక్షన్ నమూనా Calendar, Survey, మరియు Voice Portal కోసం పని చేస్తుంది.

ప్రతి ఉత్పత్తి ఏ సాధనాలను బహిర్గతం చేస్తుంది

Calendar

Calendar 7 సాధనాలుతో ఒక ప్రొడక్షన్ MCP సర్వర్‌ను అందిస్తుంది:

  • list_event_types — మీరు అందించే సమావేశ రకాలను జాబితా చేస్తుంది.
  • list_slots — ఒక సమయ విండోలో ఒక ఈవెంట్ రకం కోసం ఖాళీ స్లాట్‌లను కనుగొంటుంది.
  • create_booking — ఒక ఆహ్వానితుడి కోసం ఒక స్లాట్‌ను బుక్ చేస్తుంది.
  • cancel_booking — ఒక బుకింగ్‌ను రద్దు చేస్తుంది.
  • reschedule_booking — ఒక బుకింగ్‌ను కొత్త సమయానికి తరలిస్తుంది.
  • list_bookings — ఇప్పటికే ఉన్న బుకింగ్‌లను జాబితా చేస్తుంది.
  • get_booking — ఒక బుకింగ్‌ను id ద్వారా చదువుతుంది.

ఇది Calendarను ఒక AI షెడ్యూలింగ్ అసిస్టెంట్‌కు ఒక సహజమైన సరిపోలికగా చేస్తుంది: అది మీ ఈవెంట్ రకాలను కనుగొనగలదు, నిజమైన అందుబాటును తనిఖీ చేయగలదు, మరియు డబుల్-బుకింగ్ లేకుండా బుక్ చేయగలదు. డెవలపర్‌ల కోసం Calendar చూడండి.

Survey

Survey ఫారమ్‌లు, ప్రతిస్పందనలు, మరియు పోల్‌లతో పని చేయడానికి 10 సాధనాలుతో POST /mcp (JSON-RPC 2.0) వద్ద ఒక లైవ్ MCP సర్వర్‌ను నడుపుతుంది:

  • whoami — ప్రామాణీకరించబడిన కాలర్ మరియు సంస్థను గుర్తిస్తుంది.
  • list_forms — మీ సంస్థలోని ఫారమ్‌లను జాబితా చేస్తుంది.
  • get_form — ఒక ఫారమ్ యొక్క నిర్మాణాన్ని చదువుతుంది.
  • submit_response — ఒక ఫారమ్‌కు ఒక ప్రతిస్పందనను సమర్పిస్తుంది.
  • list_responses — ఒక ఫారమ్ కోసం ప్రతిస్పందనలను జాబితా చేస్తుంది.
  • get_response — ఒక ప్రతిస్పందనను చదువుతుంది.
  • get_response_stats — ఒక ఫారమ్ కోసం ప్రతిస్పందన గణాంకాలను సముదాయీకరిస్తుంది.
  • create_poll — ఒక త్వరిత పోల్‌ను సృష్టిస్తుంది.
  • cast_vote — ఒక పోల్‌లో ఒక ఓటు వేస్తుంది.
  • live_poll_results — ఒక పోల్ యొక్క లైవ్ టాలీని చదువుతుంది.

డెవలపర్‌ల కోసం Survey చూడండి.

Voice Portal

Voice Portal MCPను మరో దిశ నుండి సమీపిస్తుంది: ఒక MCP సర్వర్‌గా (మాత్రమే) ఉండే బదులు, మీ వాయిస్ ఏజెంట్‌లు ఒక కాల్ సమయంలో వాటి సాధనాలను ఉపయోగించగలిగేలా మిమ్మల్ని బాహ్య MCP సర్వర్‌లను నమోదు చేయడానికి అనుమతిస్తుంది. పోర్టల్‌లో, ఒక సర్వర్‌ను నమోదు చేయడానికి, దాని ఆధారాలను నిల్వ చేయడానికి, దాని ఫంక్షన్‌లను కనుగొనడానికి, మరియు ఆ సాధనాలను ఒక ఏజెంట్‌కు బైండ్ చేయడానికి Integrations → MCP Serversకు వెళ్లండి. ఏజెంట్‌ల కోసం సాధనాలు & MCP చూడండి.

ట్రాన్స్‌పోర్ట్

Calendar MCP HTTP మరియు stdio రెండింటికీ మద్దతు ఇస్తుంది, కాబట్టి మీరు ఒక రిమోట్ అసిస్టెంట్ లేదా ఒక లోకల్‌దాన్ని కనెక్ట్ చేయవచ్చు; Survey MCP కేవలం HTTP (JSON-RPC)కి మాత్రమే మద్దతు ఇస్తుంది.

  • HTTP — అసిస్టెంట్ HTTPS ద్వారా సర్వర్ యొక్క /mcp ఎండ్‌పాయింట్‌కు కనెక్ట్ అవుతుంది. హోస్ట్ చేయబడిన/రిమోట్ ఏజెంట్‌ల కోసం దీన్ని ఉపయోగించండి.
  • stdio — సర్వర్ అసిస్టెంట్ ప్రారంభించి స్టాండర్డ్ ఇన్‌పుట్/అవుట్‌పుట్ ద్వారా మాట్లాడే ఒక లోకల్ ప్రాసెస్‌గా నడుస్తుంది. లోకల్ డెస్క్‌టాప్ సాధనాల కోసం దీన్ని ఉపయోగించండి.

ప్రామాణీకరణ మరియు ఐసోలేషన్

ఒక MCP సర్వర్ ఆశించే ఆధారం ఉత్పత్తిపై ఆధారపడి ఉంటుంది:

  • Calendar — ఒక Bearer టోకెన్‌గా పంపబడిన mcp స్కోప్‌ను కలిగి ఉన్న ఒక స్కోప్డ్ API కీతో ప్రామాణీకరిస్తుంది. కీ యొక్క స్కోప్‌లు ఇప్పటికీ ప్రతి సాధన కాల్ ఏమి చేయగలదో పరిమితం చేస్తాయి, మరియు కాల్‌లు కీ యొక్క సంస్థకు పరిమితం. Developers → API keysలో ప్రతి ఏజెంట్‌కు ఒక అంకిత కీని తయారు చేయండి.
  • Survey — ఒక Bearer టోకెన్‌గా పంపబడిన మీ పోర్టల్ JWT (ఒక సెషన్ టోకెన్)తో ప్రామాణీకరిస్తుంది. టోకెన్ యొక్క సంస్థ ప్రతి కాల్‌ను స్కోప్ చేస్తుంది, కాబట్టి ఒక ఏజెంట్ ఎప్పుడూ ఆ సంస్థ యొక్క ఫారమ్‌లు మరియు ప్రతిస్పందనలను మాత్రమే చూస్తుంది.
  • Voice Portal — మీరు ఒక Voice MCP సర్వర్‌కు ప్రామాణీకరించరు; బదులుగా మీరు పోర్టల్‌లో బాహ్య MCP సర్వర్‌లను నమోదు చేస్తారు మరియు వాటి ఆధారాలను అక్కడ నిల్వ చేస్తారు (క్రింద చూడండి).

ప్రతి సందర్భంలో, కాల్‌లు ఆధారం చెందిన ఖాతా లేదా సంస్థకు పరిమితం — ఒక ఏజెంట్ మరో కస్టమర్ యొక్క డేటాను చేరుకోలేదు.

ఏజెంట్‌లకు అత్యంత ఇరుకైన ఆధారాన్ని ఇవ్వండి

Calendar కోసం, ప్రతి ఏజెంట్‌కు దానికి అవసరమైన స్కోప్‌లతో మాత్రమే ఒక అంకిత API కీని సృష్టించండి, మరియు కీ సృష్టి సమయంలో ఒకసారి మాత్రమే చూపబడుతుందని గుర్తుంచుకోండి — అప్పుడు దాన్ని కాపీ చేయండి. ఒక ఏజెంట్ తప్పుగా ప్రవర్తిస్తే లేదా దాని కీ లీక్ అయితే, మీ ఇతర ఇంటిగ్రేషన్‌లను ప్రభావితం చేయకుండా ఆ కీని డెవలపర్ ప్రాంతంలో రద్దు చేయండి.

Claude నుండి కనెక్ట్ చేయండి

MCP క్లయింట్‌లు (Claude Desktop వంటివి) ఒక సర్వర్‌ను ఎలా చేరుకోవాలో తెలిపే ఒక చిన్న JSON కాన్ఫిగ్‌ను చదువుతాయి. క్రింది ఆకారం ఉదాహరణార్థమైనది — ఉత్పత్తి యొక్క డెవలపర్ పేజీ నుండి ఖచ్చితమైన ఎండ్‌పాయింట్ మరియు ఏవైనా ఫ్లాగ్‌లను ఉపయోగించండి, మరియు ఈ ప్రయోజనం కోసం మీరు సృష్టించిన ఒక API కీని అతికించండి:

{
"mcpServers": {
"imatic-calendar": {
"url": "https://<calendar-host>/mcp",
"headers": {
"Authorization": "Bearer cal_abc123.s3cr3t_keymaterial"
}
}
}
}

ఒక లోకల్ (stdio) కనెక్షన్ కోసం, క్లయింట్ ఒక URLకు కనెక్ట్ అయ్యే బదులు సర్వర్ కమాండ్‌ను ప్రారంభిస్తుంది — మళ్లీ, ఖచ్చితమైన కమాండ్ కోసం ఉత్పత్తి యొక్క డెవలపర్ పేజీని అనుసరించండి. కనెక్ట్ అయిన తరువాత, అసిస్టెంట్‌ను దానికి ఏ సాధనాలు ఉన్నాయో అడగండి; Calendar కోసం అది పైన జాబితా చేయబడిన ఏడు సాధనాలను నివేదించాలి, మరియు మీరు దాన్ని, ఉదాహరణకు, "నా తదుపరి ఖాళీ 30-నిమిషాల స్లాట్‌ను కనుగొని దాన్ని alex@example.com కోసం బుక్ చేయి" అని అడగవచ్చు.

సంబంధితం