# MCP দিয়ে অন্য অ্যাপ থেকে Dvina ব্যবহার করুন

> Claude Code, ChatGPT বা Cursor-এর মতো একটি MCP ক্লায়েন্ট Dvina-তে সংযুক্ত করুন, সাইন ইন করুন এবং আপনার অনুমতি নিয়ে সেটিকে আপনার Dvina থেকে তথ্য পড়তে ও সেখানে তথ্য যোগ করতে দিন।

Dvina-এর নিজস্ব MCP সার্ভার আছে। Claude Code, ChatGPT বা Cursor-এর মতো একটি MCP ক্লায়েন্ট সংযুক্ত করলে সেই অ্যাপ আপনার পরিচয়ে আপনার Dvina-তে খুঁজতে, আপনার ডকুমেন্ট ও মেমরি পড়তে এবং নোট, কাজ ও রিমাইন্ডার যোগ করতে পারবে।

## শুরু করার আগে

আপনার সার্ভারের ঠিকানা লাগবে:

```text
https://api.dvina.ai/mcp
```

আপনার কোম্পানি নিজস্ব সার্ভারে Dvina চালালে, কোম্পানির নিজস্ব Dvina API ঠিকানার শেষে `/mcp` যোগ করে ব্যবহার করুন। ঠিকানাটি আপনার অ্যাডমিনের কাছে জানতে চান।

সার্ভারটি Streamable HTTP ব্যবহার করে। ক্লায়েন্টে ট্রান্সপোর্ট বেছে নিতে বললে HTTP বেছে নিন।

## একটি ক্লায়েন্ট সংযুক্ত করুন

::: tabs

=== Claude Code

1. আপনার টার্মিনালে চালান:

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Claude Code চালু করুন, `/mcp` চালান, **dvina** বেছে নিন এবং Dvina-তে সাইন ইন করুন।

=== ChatGPT

1. ChatGPT-তে MCP সার্ভার যোগ করার জায়গাটি খুলুন।
2. সার্ভারের ঠিকানা হিসেবে `https://api.dvina.ai/mcp` লিখুন এবং কীভাবে সাইন ইন করবেন তা জানতে চাইলে OAuth বেছে নিন।
3. ChatGPT বললে Dvina-তে সাইন ইন করুন।

=== Cursor

1. Open the place where Cursor lets you add an MCP server.
2. Add a server named `dvina` with the address `https://api.dvina.ai/mcp`.
3. Sign in to Dvina when Cursor asks.

:::

আপনার কোনো ক্লায়েন্ট ID বা সিক্রেট লাগবে না। প্রথমবার সংযোগের সময় ক্লায়েন্ট নিজেই Dvina-তে নিবন্ধন করে।

## সাইন ইন করুন

Dvina-এর MCP সার্ভার আপনার ব্রাউজারে OAuth দিয়ে আপনাকে সাইন ইন করায়:

1. আপনি যেভাবে সাধারণত Dvina-তে সাইন ইন করেন, সেভাবেই সাইন ইন করুন।
2. আপনি একাধিক ওয়ার্কস্পেসের সদস্য হলে, **ওয়ার্কস্পেস নির্বাচন করুন** থেকে একটি বেছে নিন, তারপর **চালিয়ে যান** বেছে নিন। ক্লায়েন্ট শুধু ওই ওয়ার্কস্পেসেই কাজ করবে।
3. **অ্যাক্সেসের অনুমতি দিন**-এর অধীনে অ্যাপের নাম যাচাই করুন, তারপর **অ্যাক্সেস দিন** বেছে নিন। অ্যাপটি চিনতে না পারলে **প্রত্যাখ্যান করুন** বেছে নিন।

ক্লায়েন্ট সংযুক্ত থাকে, তাই আপনাকে প্রতিবার সাইন ইন করতে হয় না।

## ক্লায়েন্ট কী কী করতে পারে

ক্লায়েন্ট Dvina-এর টুলগুলো দেখতে পায় এবং আপনার অনুরোধের জন্য প্রয়োজন হলে সেগুলো ব্যবহার করে:

| বিভাগ                   | ক্লায়েন্ট যা করতে পারে                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **অনুসন্ধান**             | একসঙ্গে আপনার চ্যাট, ডকুমেন্ট, মেমরি ও ওয়ার্ল্ডে অনুসন্ধান করতে পারে।                                                                                      |
| **মেমরি**             | আপনার মেমরি ফাইলের তালিকা দেখতে ও পড়তে, নতুন ফাইল যোগ করতে বা কোনো ফাইল বদলাতে পারে।                                                                               |
| **ওয়ার্ল্ড**              | আপনার বিষয়গুলোর তালিকা দেখতে, কোনো বিষয় বা অন্য যেকোনো কিছু সম্পর্কে Dvina কী জানে তা দেখাতে এবং আপনার ফিডের তালিকা দেখতে পারে।                                                  |
| **ডকুমেন্ট**          | আপনার লাইব্রেরির তালিকা দেখতে, পড়তে ও অনুসন্ধান করতে, নোট ও ফোল্ডার তৈরি করতে, ফাইল আপলোড করতে এবং ডকুমেন্ট প্রতিস্থাপন, সরানো বা নাম বদলানো কিংবা ট্র্যাশে পাঠাতে পারে। |
| **ক্যানভাস**             | আপনার ক্যানভাসগুলোর তালিকা দেখতে ও পড়তে, ক্যানভাস তৈরি করতে বা কোনো পৃষ্ঠা নতুন করে লিখতে পারে।                                                                             |
| **কাজ ও লক্ষ্য**    | আপনার কাজগুলোর তালিকা দেখতে ও সেগুলো কী করেছে তা পড়তে, কোনো কাজ বা লক্ষ্য পূরণের জন্য কাজ শুরু করতে, কোনো কাজকে আরও করণীয় পাঠাতে বা থামাতে পারে।                |
| **নির্ধারিত বার্তা** | এগুলোর তালিকা দেখতে, একবারের জন্য বা বারবার পাঠানোর জন্য বার্তা বা রিমাইন্ডার নির্ধারণ করতে কিংবা বাতিল করতে পারে।                                                                 |
| **এজেন্ট ও দক্ষতা**  | আপনার এজেন্ট ও দক্ষতাগুলোর তালিকা দেখতে ও পড়তে, এজেন্ট তৈরি করতে, দক্ষতা যোগ করতে বা যেকোনোটি বদলাতে পারে।                                                        |
| **প্রকল্প**           | আপনার প্রকল্পগুলোর তালিকা দেখতে এবং কোনো প্রকল্পের ফোল্ডার ও সাম্প্রতিক কাজ দেখাতে পারে।                                                                             |
| **শেয়ারিং**            | কোনো আইটেমে কার অ্যাক্সেস আছে ও অন্যরা আপনার সঙ্গে কী শেয়ার করেছেন তা দেখতে, অথবা কাউকে অ্যাক্সেস দিতে বা কারও অ্যাক্সেস সরাতে পারে।                                           |
| **সেটিংস**           | আপনার পছন্দগুলো দেখাতে বা মেমরি চালু বা বন্ধ করতে পারে।                                                                                             |

ক্লায়েন্ট কোনো কিছু স্থায়ীভাবে মুছতে, পাবলিক লিঙ্ক খুলতে, অ্যাপ সংযুক্ত বা বিচ্ছিন্ন করতে কিংবা অ্যাডমিন বা বিলিং সেটিংস বদলাতে পারে না।

## পরিবর্তন অনুমোদন করুন

Dvina-এর অন্য সব জায়গার মতো ক্লায়েন্টের কাজেও একই নিয়ম প্রযোজ্য:

- পড়ার কাজ আপনার অনুমতি না চেয়েই চলে।
- নতুন কিছু যোগ করা, যেমন নোট, মেমরি ফাইল বা কাজ, আপনার অনুমতি না চেয়েই চলে। এতে আগে থেকে থাকা কোনো কিছু কখনো বদলায় না।
- কোনো কিছু বদলানো বা সরানো, যেমন ডকুমেন্ট ট্র্যাশে পাঠানো, ক্যানভাসের পৃষ্ঠা নতুন করে লেখা, কাজ থামানো বা আইটেম শেয়ার করার আগে আপনার অনুমতি চাওয়া হয়। ক্লায়েন্ট পরিবর্তনটি সম্পর্কে Dvina-এর নিজস্ব সারাংশ দেখায়, আর আপনি তা অনুমোদন বা প্রত্যাখ্যান করেন। প্রত্যাখ্যান করলে কিছুই বদলায় না।

> [!NOTE]
> কোনো ক্লায়েন্ট আপনার কাছে নিশ্চিতকরণ চাইতে না পারলে, Dvina সেই ক্লায়েন্টের মাধ্যমে পরিবর্তনটি করে না। পরিবর্তে Dvina অ্যাপে পরিবর্তনটি করুন, অথবা এমন ক্লায়েন্ট ব্যবহার করুন যা আপনার কাছে নিশ্চিতকরণ চাইতে পারে।

## আপনার অ্যাক্সেস ও আপনার কোম্পানির নিয়ম

Dvina-তে আপনি যা দেখতে ও করতে পারেন, ক্লায়েন্ট আপনার হয়ে সেই অ্যাক্সেস নিয়েই কাজ করে:

- আপনি যতক্ষণ ওয়ার্কস্পেসের সদস্য থাকেন, এটি শুধু ততক্ষণই কাজ করে এবং আপনার ভূমিকার অনুমোদিত কাজগুলোই করতে পারে।
- আপনার অ্যাডমিন কোনো সুবিধা বন্ধ করে দিলে, যেমন ফাইল আপলোড, ক্লায়েন্টও তা ব্যবহার করতে পারে না।
- ক্লায়েন্ট যা যোগ করে বা বদলায়, তা অ্যাপের মতোই আপনার কোম্পানির ডেটা সুরক্ষা নিয়মের মধ্য দিয়ে যায়।
- এটি যা যোগ করে বা বদলায়, তা আপনার [অডিট লগে](/docs/teams/audit-log) আপনার হয়ে সহকারীর করা কাজ হিসেবে নথিভুক্ত হয়, সঙ্গে কোন ক্লায়েন্ট থেকে এসেছে তাও থাকে।
- এটি যা করে, তা আপনার স্বাভাবিক সীমার মধ্যে আপনার ব্যবহারের হিসাবে গণনা করা হয়।

## OAuth-এর বদলে API কী দিয়ে সংযোগ করুন

Enterprise প্ল্যানে, ক্লায়েন্ট সাইন ইন করার বদলে ব্যক্তিগত অ্যাক্সেস টোকেন দিয়ে সংযোগ করতে পারে। OAuth দিয়ে সাইন ইন করতে পারে না এমন ক্লায়েন্টের জন্য, অথবা কোনো স্ক্রিপ্টের জন্য এটি ব্যবহার করুন।

1. সেটিংস খুলে **API অ্যাক্সেস** বেছে নিন।
2. **ব্যক্তিগত অ্যাক্সেস টোকেন**-এর অধীনে **টোকেন তৈরি করুন** বেছে নিন।
3. একটি **নাম** লিখুন, **অ্যাক্সেস** এবং কখন **মেয়াদ শেষ হবে** তা বেছে নিন, তারপর **টোকেন তৈরি করুন** বেছে নিন।
4. **আপনার টোকেন কপি করুন**-এর অধীনে টোকেনটি কপি করুন। এটি শুধু এই একবারই দেখানো হবে।

ক্লায়েন্টের যে অ্যাক্সেস দরকার, তা বেছে নিন:

- **শুধু পড়া:** ক্লায়েন্ট শুধু পড়ার টুলগুলোই দেখতে পায়। এটি আপনার Dvina-তে অনুসন্ধান করতে ও পড়তে পারে, কিন্তু কিছু যোগ করতে বা বদলাতে পারে না।
- **পড়া ও লেখা:** ক্লায়েন্ট সব টুল দেখতে পায়, আর OAuth-এর মতোই পরিবর্তনের জন্য আপনার অনুমোদন চাওয়া হয়।

`Authorization` হেডারে `Bearer`-এর পরে টোকেনটি পাঠান। যেমন, Claude Code-এ:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

অন্য কোনো ক্লায়েন্টে, MCP সার্ভারের জন্য হেডার সেট করার জায়গায় একই হেডার যোগ করুন।

যে ওয়ার্কস্পেসে টোকেনটি তৈরি করেছেন, সেখানে আপনার বর্তমান ভূমিকার অ্যাক্সেস নিয়ে এটি আপনার হয়ে কাজ করে। এটি প্রতিস্থাপন করতে, **ব্যক্তিগত অ্যাক্সেস টোকেন**-এর অধীনে টোকেনটি খুলে **রোটেট করুন…** বেছে নিন: নতুন টোকেন এটি প্রতিস্থাপন করবে, আর পুরোনোটি সঙ্গে সঙ্গে কাজ করা বন্ধ করবে। এটি বন্ধ করতে **প্রত্যাহার করুন…** বেছে নিন: এটি ব্যবহার করে এমন সবকিছু সঙ্গে সঙ্গে কাজ করা বন্ধ করবে।

টোকেন সম্পর্কে আরও জানতে, [API অ্যাক্সেস](/docs/dvina-mcp/api-access) দেখুন।

## সম্পর্কিত

- [কাস্টম অ্যাপ ও MCP সার্ভার](/docs/connectors/custom-apps)
- [API অ্যাক্সেস](/docs/dvina-mcp/api-access)
- [dvina কমান্ড ব্যবহার করুন](/docs/dvina-mcp/cli)
- [টিমের সারসংক্ষেপ](/docs/teams/overview)