msgraph — скилл
Скилл с локальным индексом 27 700 методов Microsoft Graph: поиск эндпоинтов, права и вызовы API из командной строки
- 119 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- После входа агент может читать почту, пользователей и политики арендатора Microsoft 365 в рамках выданных прав
- Изменяющие вызовы Graph возможны, защита держится на подтверждении, а токены по умолчанию кэшируются на диске
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/msgraphОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- После входа агент может читать почту, пользователей и политики арендатора Microsoft 365 в рамках выданных прав
- Изменяющие вызовы Graph возможны, защита держится на подтверждении, а токены по умолчанию кэшируются на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
msgraph дает агенту актуальные сведения об API Microsoft Graph, который обновляется еженедельно и быстро уходит за пределы обучающих данных модели. Скилл содержит локальные индексы: 27 700 эндпоинтов из OpenAPI, 6 200 страниц документации с правами, параметрами запроса и заголовками, 4 200 схем ресурсов со списком свойств и операторов `$filter`. Рядом лежат проверенные вручную примеры запросов от сообщества. Поиск идет локально и без сети тремя командами: `msgraph sample-search --query "conditional access policies"`, `msgraph api-docs-search --endpoint /users --method GET` и `msgraph openapi-search --query "send mail"`. Бинарник на Go собран для macOS, Linux и Windows на amd64 и arm64, зависимости на рабочей машине не нужны. Для выполнения запросов есть вход через MSAL в браузере с запасным кодом устройства и режим приложения без пользователя. Команды `msgraph auth signin` и `msgraph graph-call GET /me` работают сразу, а запись требует явного подтверждения. Если подключен MCP-сервер Lokka или другой сервер Graph, скилл передает вызов ему.
Для кого. Администраторам Microsoft 365 и Entra ID и разработчикам интеграций с Graph, которые пишут запросы с агентом и устали от выдуманных эндпоинтов.
Подходит, если
- Агент выдает устаревший или несуществующий путь Graph, и его надо привязать к актуальному индексу
- Перед вызовом важно узнать, какие права, делегированные или приложения, требует конкретный эндпоинт
- Задачу по политикам условного доступа или почте надо перевести в точный запрос Graph по готовому примеру
- Нужно быстро прочитать профиль или последние сообщения через `graph-call GET` без отдельного MCP-сервера
Не подходит, если
- Задача не про Microsoft Graph, например SDK Azure или API Power Platform: индекс охватывает только Graph
- Доступ к арендатору запрещен политикой организации: прямой вход через MSAL использует идентификатор приложения по умолчанию
- Требуется только документация без выполнения запросов: хватит локального поиска, а вход в аккаунт не нужен
Пример запроса к агенту
Найди эндпоинт Microsoft Graph для списка политик условного доступа и скажи, какие права для него нужныОграничения
Вход по умолчанию идет через клиентское приложение с готовым идентификатором, свое задается переменной `MSGRAPH_CLIENT_ID`, арендатор по умолчанию `common`, версия API по умолчанию `beta`: ее эндпоинты менее стабильны, чем `v1.0`. Кэш токенов сохраняется на диск, отключить его можно переменной `MSGRAPH_NO_TOKEN_CACHE=true`. Поиск работает без сети, но индексы обновляются только вместе с новой версией скилла, и список эндпоинтов может отставать от Graph. Примеры сообщества пополняются постепенно. В README нет перечня поддерживаемых агентов, формат SKILL.md общий.
Как отключить. Удалите папку `msgraph` из каталога скиллов агента (например `~/.claude/skills/msgraph`). Кэш токенов лежит на диске, чтобы он не сохранялся, задавайте `MSGRAPH_NO_TOKEN_CACHE=true`.
Частые вопросы
Как поставить msgraph в Claude Code?
Выполните `npx skills add merill/msgraph`. Без Skills CLI скачайте `msgraph.zip` из последнего релиза и распакуйте в `~/.claude/skills/`.
Нужна ли авторизация для поиска по API?
Нет, три команды поиска работают локально и без входа. Авторизация `msgraph auth signin` нужна только для вызова `graph-call`.
Может ли скилл изменить данные в Microsoft 365?
Да, но запись защищена: GET-запросы разрешены сразу, а изменяющие операции требуют явного подтверждения. Права вызова ограничены тем, что вы выдали при входе.
Работает ли скилл вместе с MCP-сервером?
Да, он совместим с Lokka (lokka.dev) и любым другим MCP-сервером Graph. Скилл ищет и проверяет запрос, а выполнение отдает серверу.
Какие переменные окружения настраивают скилл?
`MSGRAPH_CLIENT_ID` заменяет идентификатор приложения, `MSGRAPH_TENANT_ID` задает арендатора (по умолчанию `common`), `MSGRAPH_API_VERSION` выбирает `beta` или `v1.0` (по умолчанию `beta`), а `MSGRAPH_NO_TOKEN_CACHE` отключает сохранение токенов на диск.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыMCP-сервер для Microsoft Graph и Azure: тенантом Microsoft 365 управляют обычными словами, от групп Entra до расходов Azure
Скиллы Microsoft Learn почти по каждому сервису Azure: лимиты, настройка, безопасность, архитектура и диагностика со ссылками на документацию
Microsoft Agent Skills
Agent Skills
Официальные скиллы Microsoft для работы агентов с Azure SDK и Foundry на Python, .NET, TypeScript, Java и Rust
GPU-профайлер для ИИ-агентов: агент запускает vLLM или SGLang под graphsignal-run, читает метрики и подбирает флаги для скорости
Скиллы и CLI учат агента рисовать корректные схемы draw.io для AWS, Azure, GCP, Databricks и BPMN с проверкой структуры
Подборка скиллов и агентов для Copilot по Azure, API Management, Terraform и диаграммам с установкой через skills CLI или APM
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| msgraph (эта карточка) | нет | 119 | ||
| Microsoft Agent Skills | нет | 3 177 | набор скиллов по SDK и сервисам Microsoft для разработки | |
| Microsoft Learn MCP Server | да | не нужна | 1 975 | ищет в документации Microsoft Learn через MCP, без вызова Graph |
Коротко о README
README объясняет проблему устаревших знаний модели о Graph и решение в виде локальных индексов, затем дает таблицу индексов, список возможностей и быстрый старт. Отдельные разделы описывают переменные окружения, сборку из исходников на Go 1.22 и структуру проекта.
Бейдж для README
Исходный SKILL.md
--- name: msgraph description: Up-to-date Microsoft Graph API knowledge for AI agents. Search 27,700+ Graph APIs, endpoint docs, resource schemas, and community samples — all locally, no network calls. Use when the agent needs to find, understand, or call Microsoft Graph endpoints. license: MIT metadata: author: merill version: "1.0.19" --- # Microsoft Graph Agent Skill Search, look up, and call any of the 27,700+ Microsoft Graph APIs — all locally, no network calls needed. Use the three search commands to find the right endpoint, check permissions and parameters, then optionally execute calls directly or hand off to a Graph MCP server. ## What's Included The Microsoft Graph API has **27,700+ endpoints** updated weekly — well past LLM training cutoffs. This skill bundles the complete API surface as local indexes that you search instantly with no network calls. | Index | Count | What it contains | |---|---|---| | OpenAPI endpoints | 27,700+ | Path, method, summary, description, permission scopes | | Endpoint docs | 6,200+ | Permissions (delegated/app), query parameters, required headers, default vs `$select`-only properties | | Resource schemas | 4,200+ | All properties with types, supported `$filter` operators, default/select-only flags | | Community samples | Growing | Hand-verified queries mapping natural-language tasks to exact API calls | ## How to Run The `msgraph` CLI is bundled with this skill. Run all commands through the launcher script in this skill's directory: - **macOS / Linux**: `bash <path-to-this-skill>/scripts/run.sh <command> [args...]` - **Windows**: `powershell <path-to-this-skill>/scripts/run.ps1 <command> [args...]` For example, to search for mail-related APIs on macOS: ``` bash /home/user/.opencode/skills/msgraph/scripts/run.sh openapi-search --query "send mail" ``` In all examples below, `msgraph` is shorthand for the full launcher invocation. ## Finding the Right API This is the primary purpose of the skill. Follow this progressive lookup strategy — each level adds detail: 1. **Your own knowledge** — try first for well-known endpoints (`/me`, `/users`, `/groups`). 2. **`sample-search`** — curated, hand-verified samples. Highest quality. Use for common tasks and multi-step workflows.