OO

openwhispr/openwhispr-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

15 stars 7 forks Качество 73 Тренд 35

Официальный удаленный MCP для OpenWhispr API

Обзор

Удаленный MCP-сервер для доступа к заметкам, папкам, транскрипциям, словарю, фрагментам и статистике использования любого помощника ИИ, который поддерживает протокол Model Context. Находится в https://mcp.openwhispr.com/mcp Пропустите этот шаг, если вы подключаетесь к Claude (веб-сайт, рабочий стол или мобильный): он подписывает вас с OAuth и никогда не нуждается в ключе API. Для других клиентов сгенерируйте ключ API из настольного приложения OpenWhispr. Ключ начинается с owk live . Ассистенты ИИ могут создавать свой собственный API-ключ без настольного приложения: 1. : POST https://api.openwhispr.com/api/v1/auth/email-code с {"email": "[email protected]"] 2. : Проверьте свою электронную почту на 6-значный код проверки 3. : POST https://api.openwhispr.com/api/v1/auth/email-code/verify с {"email": "...", "code": "123456"] 4. : POST https://api.openwhispr.com/api/v1/keys/create с авторизацией: Bearer owt ...

Обзор (машинный перевод)

Удаленный MCP-сервер для доступа к заметкам, папкам, транскрипциям, словарю, фрагментам и статистике использования любого помощника ИИ, который поддерживает протокол Model Context.

Находится в https://mcp.openwhispr.com/mcp

Настройка

###1 Получить ключ API

Пропустите этот шаг, если вы подключаетесь к Claude (веб-сайт, рабочий стол или мобильный): он подписывает вас с OAuth и никогда не нуждается в ключе API.

Для других клиентов сгенерируйте ключ API из настольного приложения OpenWhispr в разделе Настройки > Ключи API. Ваш ключ начинается с [1].

###Альтернатива: агентская самооценка

Ассистенты ИИ могут создавать свой собственный API-ключ без настольного приложения:

  1. **Запросить код **: POST https://api.openwhispr.com/api/v1/auth/email-code с {"email": "[email protected]"}
  2. ** Введите код **: Проверьте свою электронную почту на 6-значный код проверки
  3. ** Проверить **: POST https://api.openwhispr.com/api/v1/auth/email-code/verify с {"email": "...", "code": "123456"}
  4. **Создать ключ **: POST https://api.openwhispr.com/api/v1/keys/create с Authorization: Bearer owt_... и {"name": "My Agent", "scopes": ["notes:read", "notes:write", "dictionary:write", "snippets:write"]}

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

OpenWhispr MCP Server

Remote MCP server for accessing your OpenWhispr notes, folders, transcriptions, dictionary, snippets, and usage stats from any AI assistant that supports the Model Context Protocol.

Hosted at https://mcp.openwhispr.com/mcp

Setup

1. Get an API key

Skip this step if you are connecting from Claude (web, desktop, or mobile): it signs you in with OAuth and never needs an API key.

For other clients, generate an API key from the OpenWhispr desktop app under Settings > API Keys. Your key starts with owk_live_.

Alternative: Agent self-setup

AI assistants can create their own API key without the desktop app:

  1. Request a code: POST https://api.openwhispr.com/api/v1/auth/email-code with {"email": "[email protected]"}
  2. Enter the code: Check your email for a 6-digit verification code
  3. Verify: POST https://api.openwhispr.com/api/v1/auth/email-code/verify with {"email": "...", "code": "123456"}
  4. Create a key: POST https://api.openwhispr.com/api/v1/keys/create with Authorization: Bearer owt_... and {"name": "My Agent", "scopes": ["notes:read", "notes:write", "dictionary:write", "snippets:write"]}

The returned owk_live_ key works the same as one created in the desktop app.

2. Connect your AI assistant

Claude (web, desktop, mobile)

  1. Open Customize > Connectors > Add custom connector
  2. Paste https://mcp.openwhispr.com/mcp and click Add
  3. Sign in to OpenWhispr and approve the requested access

No API key is needed. Claude receives a short-lived, scoped token that it refreshes automatically.

Claude Code

claude mcp add openwhispr --transport http https://mcp.openwhispr.com/mcp \
  --header "Authorization: Bearer owk_live_YOUR_KEY"

Cursor / VS Code

Add to your MCP config (~/.cursor/mcp.json or VS Code MCP settings):

{
  "mcpServers": {
    "openwhispr": {
      "url": "https://mcp.openwhispr.com/mcp",
      "headers": {
        "Authorization": "Bearer owk_live_YOUR_KEY"
      }
    }
  }
}

Available Tools

Tool Description
list_notes List notes with optional folder filtering and cursor pagination
get_note Get a single note by ID
create_note Create a new note
update_note Update a note’s title, content, or folder
delete_note Delete a note
search_notes Semantic and full-text search across notes
list_folders List all folders
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "openwhispr": { "url": "https://mcp.openwhispr.com/mcp", "headers": { "Authorization": "Bearer owk_live_YOUR_KEY" } } } }