Sn MCP Server

🚀 SignNow MCP Server

SignNow MCP Serverは、AIエージェントに対して、SignNowの電子署名ワークフロー（テンプレート、埋め込み署名、招待、ステータス追跡、ドキュメントのダウンロードなど）に対する安全で構造化されたアクセスを、STDIOまたはStreamable HTTPを通じて提供するModel Context Protocol (MCP)サーバーです。

mcp-name: io.github.signnow/sn-mcp-server

🚀 クイックスタート

前提条件

• SignNowアカウント。無料の開発者アカウントを作成してください。
• SignNowの認証情報：アカウントのメールアドレス、パスワード、およびアプリケーションの基本認証トークンが必要です。はじめにを参照してください。
• アクティブなSignNow APIアプリケーション。
• システムにPython 3.11以上がインストールされていること（python3 --versionで確認）
• UVXがインストールされていること（uvx --versionで確認）。最速のセットアップに推奨されます。
• 環境変数が設定されていること
• クライアントがStreamable HTTPをサポートしている場合、ローカルで実行する代わりに、事前にデプロイされたサーバーURL https://mcp-server.signnow.com/mcp を使用できます。

クイック実行 (uvx)

uv を使用している場合、パッケージをインストールせずにサーバーを実行できます。

uvx --from signnow-mcp-server sn-mcp serve

1. 環境変数の設定

# SignNowの認証情報を含む.envファイルを作成します
# ソースコードがある場合は、env.exampleからコピーできます
# または、必要な変数を手動で.envファイルに作成します（以下の環境変数のセクションを参照）

2. インストールと実行

オプションA: PyPIからインストール（推奨）

# PyPIからパッケージをインストールします
pip install signnow-mcp-server

# スタンドアロンモードでMCPサーバーを実行します
sn-mcp serve

オプションB: ソースからインストール（開発用）

# 1) クローンして設定します
git clone https://github.com/signnow/sn-mcp-server.git
cd sn-mcp-server
cp .env.example .env
# .envに値を入力します

# 2) インストール（開発用に編集可能）
pip install -e .

# 3) STDIO MCPサーバーとして実行します（ローカルツールとインスペクターに推奨）
sn-mcp serve

STDIOは、デスクトップクライアントとローカルテストに最適です。

ローカル/リモート (HTTP)

# 127.0.0.1:8000でHTTPサーバーを起動します
sn-mcp http

# カスタムホスト/ポート
sn-mcp http --host 0.0.0.0 --port 8000

# 開発用リロード
sn-mcp http --reload

デフォルトでは、Streamable HTTPのMCPエンドポイントは /mcp の下で提供されます。例のURL:

http://localhost:8000/mcp

Docker

# ビルド
docker build -t sn-mcp-server .

# HTTPモードで実行（コンテナに推奨）
docker run --env-file .env -p 8000:8000 sn-mcp-server sn-mcp http --host 0.0.0.0 --port 8000

多くのクライアントでは、コンテナ内のSTDIOは信頼性が低いです。Dockerを使用する場合は、HTTPを使用することをお勧めします。

Docker Compose

# MCPサーバーのみ
docker-compose up sn-mcp-server

# 両方のサービス（定義されている場合）
docker-compose up

✨ 主な機能

• テンプレートとグループ
  • すべてのテンプレートとテンプレートグループを閲覧します。
  • テンプレートからドキュメントまたはグループを作成します（ワンショットフローを含む）。
• 招待と埋め込みUX
  • メール招待と順序付けられた受信者。
  • アプリ内エクスペリエンスのための埋め込み署名/送信/エディターリンク。
• ステータスと取得
  • 招待ステータスとステップの詳細を確認します。
  • 最終ドキュメントをダウンロードします（単一または結合）。
  • プログラムによる判断のために、正規化されたドキュメント/グループ構造を読み取ります。
• トランスポート
  • STDIO（ローカルクライアントに最適）
  • Streamable HTTP（Docker/リモートに最適）

📚 ドキュメント

設定

.env.example を .env にコピーし、値を入力してください。すべての設定は起動時に pydantic-settings を介して検証されます。

認証オプション

1) ユーザー名 / パスワード（デスクトップ開発フローに推奨）

SIGNNOW_USER_EMAIL=<email>
SIGNNOW_PASSWORD=<password>
SIGNNOW_API_BASIC_TOKEN=<base64 basic token>

2) OAuth 2.0（ホスト型/高度なシナリオ用）

SIGNNOW_CLIENT_ID=<client_id>
SIGNNOW_CLIENT_SECRET=<client_secret>
# + 以下のOAuthサーバーとRSA設定

一部のデスクトップクライアントで実行する場合、ユーザー名/パスワードのみがサポートされる場合があります。

SignNowとOAuthの設定

# SignNowのエンドポイント（デフォルトを表示）
SIGNNOW_APP_BASE=https://app.signnow.com
SIGNNOW_API_BASE=https://api.signnow.com

# オプションの直接APIトークン（通常の使用には必要ありません）
SIGNNOW_TOKEN=<access_token>

# OAuthサーバー（OAuthモードを有効にした場合）
OAUTH_ISSUER=<your_issuer_url>
ACCESS_TTL=3600
REFRESH_TTL=2592000
ALLOWED_REDIRECTS=<comma,separated,uris>

# OAuth用のRSAキー（本番環境では重要）
OAUTH_RSA_PRIVATE_PEM=<PEM content>
OAUTH_JWK_KID=<key id>

本番環境のキー管理

本番環境で OAUTH_RSA_PRIVATE_PEM が欠落している場合、再起動のたびに新しいRSAキーが生成され、すべての既存のトークンが無効になります。本番環境では、シークレット管理を介して永続的な秘密鍵を常に提供してください。

クライアントの設定

VS Code — GitHub Copilot (エージェントモード) / Cursor

ワークスペースに .vscode/mcp.json / .cursor/mcp.json を作成します。

STDIO (ローカル):

{
  "servers": {
    "signnow": {
      "command": "sn-mcp",
      "args": ["serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

STDIO (uvx — ローカルインストール不要):

{
  "servers": {
    "signnow": {
      "command": "uvx",
      "args": ["--from", "signnow-mcp-server", "sn-mcp", "serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

HTTP (リモートまたはDocker):

{
  "servers": {
    "signnow": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

次に、Chat → エージェントモードを開き、signnow ツールを有効にし、プロンプトで使用します。

注意: 同じ設定がCursorでも適用されます — MCP設定（STDIOまたはHTTP）の下に追加してください。STDIOの場合、上記のように uvx を使用することもできます。

Claude Desktop

デスクトップ拡張機能または手動のMCP設定（開発者 → 設定の編集）を使用します。

手順:

1. Claude Desktopを開き → 開発者 → 設定の編集
2. mcpServers の下に新しいサーバーエントリを追加します
3. 保存してClaude Desktopを再起動します

例:

STDIO (ローカルインストール):

{
  "mcpServers": {
    "signnow": {
      "command": "sn-mcp",
      "args": ["serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

STDIO (uvx — ローカルインストール不要):

{
  "mcpServers": {
    "signnow": {
      "command": "uvx",
      "args": ["--from", "signnow-mcp-server", "sn-mcp", "serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

HTTP (リモートまたはDocker):

{
  "mcpServers": {
    "signnow": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

次に、Claudeのチャットでサーバーを有効にし、ツールを使用し始めます。

Glama (ホスト型MCP)

最小限の設定でこのサーバーをGlamaでデプロイして実行します。

手順:

1. Glamaのサーバーページを開きます: sn-mcp-server on Glama
2. 赤い「Deploy Server」ボタンをクリックします
3. 環境変数に以下を提供します:
   • SIGNNOW_USER_EMAIL
   • SIGNNOW_PASSWORD
   • SIGNNOW_API_BASIC_TOKEN
   • （他の変数はデフォルトのままにできます）
4. Glamaでアクセストークンを作成し、エンドポイントURLをコピーします。次のようになります:

https://glama.ai/endpoints/{someId}/mcp?token={glama-mcp-token}

このHTTP MCP URLを、HTTPトランスポートをサポートする任意のクライアント（例: VS Code/CursorのJSON設定または上記のClaude DesktopのHTTP例）で使用します。

MCP Inspector (テスト用)

ツールとスキーマを視覚的に探索するのに最適です。

# インスペクターを起動します（localhostでUIを開きます）
npx @modelcontextprotocol/inspector

# 接続 (STDIO): サーバーをローカルで実行して接続します
sn-mcp serve

# または接続 (HTTP): http://localhost:8000/mcp を使用します

ツールをリストし、JSON引数で呼び出し、レスポンスを検査することができます。

ツール

各ツールは簡潔に説明されています。正確なJSONスキーマを表示するには、MCPクライアント（例: インスペクター）を使用してください。

• list_all_templates — 簡略化されたメタデータを持つテンプレートとテンプレートグループをリストします。limit/offset ページネーションをサポートします（デフォルト: ページあたり50項目）。
• list_documents — ドキュメント、ドキュメントグループ、およびステータスを閲覧します。limit/offset ページネーションをサポートします（デフォルト: ページあたり50項目）。
• create_from_template — テンプレート/グループからドキュメントまたはグループを作成します。
• send_invite — メール招待（ドキュメントまたはグループ）、順序付けられた受信者をサポートします。
• create_embedded_invite — メール配信なしの埋め込み署名セッションを作成します。
• create_embedded_sending — 埋め込み「送信/管理」エクスペリエンスを作成します。
• create_embedded_editor — フィールドを配置/調整するための埋め込みエディターリンクを作成します。
• send_invite_from_template — ワンショット: テンプレートから作成して招待します。
• create_embedded_sending_from_template — ワンショット: テンプレート → 埋め込み送信。
• create_embedded_editor_from_template — ワンショット: テンプレート → 埋め込みエディター。
• create_embedded_invite_from_template — ワンショット: テンプレート → 埋め込み署名。
• get_invite_status — ドキュメントまたはグループの現在の招待ステータス/ステップを取得します。
• get_document_download_link — 直接ダウンロードリンク（グループの場合は結合出力）を取得します。
• get_signing_link — ドキュメントまたはドキュメントグループの署名リンクを取得します。
• get_document — フィールド値を持つ正規化されたドキュメント/グループ構造を取得します。
• update_document_fields — 個々のドキュメントのテキストフィールドを事前入力します。

ヒント: list_all_templates → create_from_template → create_embedded_* / send_invite から始め、次に get_invite_status と get_document_download_link を使用します。

FAQ / ヒント

• STDIOとDockerのどちらを選ぶべきですか？ ローカル開発にはSTDIOを推奨します。Docker内では、HTTPを使用してください。
• サンドボックスと本番環境の違いは何ですか？ SignNowのサンドボックス/開発用の認証情報から始めてください。本番環境では、適切なOAuthと永続的なRSA秘密鍵が必要です。
• 正確なツールスキーマはどこで見ることができますか？ MCPインスペクターまたはクライアントの「ツール詳細」ビューを使用してください。
• サンプルはどこにありますか？ このリポジトリの examples/ を参照して、スターター統合を確認してください。

サンプル

examples/ ディレクトリには、SignNow MCP Serverを人気のAIエージェントフレームワークと統合する実際のサンプルが含まれています。

• LangChain - langchain-mcp-adapters を使用したLangChainエージェントとの統合
• LlamaIndex - llama-index-tools-mcp を使用したLlamaIndexエージェントとの統合
• SmolAgents - ネイティブMCPサポートを使用したSmolAgentsフレームワークとの統合

各サンプルは、以下の方法を示しています。

• MCPサーバーをサブプロセスとして起動する方法
• MCPツールをフレームワーク固有のツール形式に変換する方法
• SignNowの機能を使用できるエージェントを作成する方法
• 環境変数の設定を処理する方法

サンプルを実行するには、次のコマンドを実行します。

# 必要な依存関係をインストールしていることを確認します
pip install langchain-openai langchain-mcp-adapters  # LangChainサンプルの場合
pip install llama-index-tools-mcp                   # LlamaIndexサンプルの場合
pip install smolagents                              # SmolAgentsサンプルの場合

# .envファイルにSignNowの認証情報とLLMの設定を設定します
# 次に、サンプルを実行します
python examples/langchain/langchain_example.py
python examples/llamaindex/llamaindex_example.py
python examples/smolagents/stdio_demo.py

有用なリソース

サンプルアプリ

SignNow APIを使用して、ソフトウェアからドキュメントの準備、署名、および送信をすばやくテストするための、すぐに使えるサンプルアプリを探索してください。 サンプルアプリを試してみてください。

APIドキュメント

SignNow APIのリクエスト、パラメータ、コード例、および可能なエラーに関する技術的な詳細を見つけてください。詳細なガイドとユースケースでAPIの機能について学びましょう。 APIドキュメントを読んでください。

SignNow API Helper MCP

AIを接続して、APIドキュメントにアクセスし、複雑な署名ワークフローのコードを生成し、統合エラーを自動的にトラブルシューティングします。 API Helper MCPにアクセス

📄 ライセンス

MIT — LICENSE.md を参照してください。

概要

SignNow MCP Serverは、SignNowチームによって管理されています。GitHubのプルリクエストを通じて、問題の報告や貢献を歓迎します。