Skip to main content
Glama
deenesjakoruzh
signnow

SignNow MCP Server

Official
by signnow
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

SignNow REST APIは、署名者、作成者、送信者に対してシームレスな電子署名体験を提供します。ドキュメントの事前入力、複数署名者向けのブランド化された埋め込みワークフローの作成、支払いの要求、署名ステータスのリアルタイム追跡が可能です。あらゆるデバイスで、シンプルかつ安全で直感的な署名を実現します。

SignNow APIでできること:

  • ロールベースの順序で署名用のドキュメントやドキュメントグループを送信

  • ドキュメントから再利用可能なテンプレートを作成

  • ドキュメントフィールドにデータを事前入力

  • 署名フローの一部として支払いを回収

  • ドキュメントの送信、署名、編集体験をWebサイト、アプリケーション、または任意の記録システムに埋め込み

  • 署名の進捗状況を追跡し、完了したドキュメントをダウンロード

SignNow MCPサーバー

SignNow電子署名ワークフロー（テンプレート、埋め込み署名、招待、ステータス追跡、ドキュメントダウンロード）への安全で構造化されたアクセスを、STDIOまたはStreamable HTTP経由でAIエージェントに提供するモデルコンテキストプロトコル（MCP）サーバーです。

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

目次

Related MCP server: Gmail MCP Server by CData

機能

  • テンプレートとグループ

    • すべてのテンプレートとテンプレートグループを閲覧

    • テンプレートからドキュメントやグループを作成（ワンショットフローを含む）

  • 招待と埋め込みUX

    • メール招待と順序指定された受信者

    • アプリ内体験のための埋め込み署名/送信/エディターリンク

  • ステータスと取得

    • 招待ステータスとステップ詳細の確認

    • 最終ドキュメントのダウンロード（単一または結合）

    • プログラムによる判断のための正規化されたドキュメント/グループ構造の読み取り

  • トランスポート

    • STDIO（ローカルクライアントに最適）

    • Streamable HTTP（Docker/リモートに最適）

クイックスタート

前提条件

  • SignNowアカウント。無料の開発者アカウントを作成してください。

  • SignNow認証情報：アカウントのメールアドレス、パスワード、およびアプリケーションのBasic認証トークンが必要です。はじめにを参照してください。

  • アクティブな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. 環境変数の設定

# Create .env file with your SignNow credentials
# You can copy from env.example if you have the source code
# Or create .env file manually with required variables (see Environment Variables section below)

2. インストールと実行

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

# Install the package from PyPI
pip install signnow-mcp-server

# Run MCP server in standalone mode
sn-mcp serve

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

# 1) Clone & configure
git clone https://github.com/signnow/sn-mcp-server.git
cd sn-mcp-server
cp .env.example .env
# fill in your values in .env

# 2) Install (editable for dev)
pip install -e .

# 3) Run as STDIO MCP server (recommended for local tools & Inspector)
sn-mcp serve

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

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

# Start HTTP server on 127.0.0.1:8000
sn-mcp http

# Custom host/port
sn-mcp http --host 0.0.0.0 --port 8000

# Dev reload
sn-mcp http --reload

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

http://localhost:8000/mcp

Docker

# Build
docker build -t sn-mcp-server .

# Run HTTP mode (recommended for containers)
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

# Only the MCP server
docker-compose up sn-mcp-server

# Both services (if defined)
docker-compose up

設定

.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 server & RSA settings below

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

SignNow & OAuth設定

# SignNow endpoints (defaults shown)
SIGNNOW_APP_BASE=https://app.signnow.com
SIGNNOW_API_BASE=https://api.signnow.com

# Optional direct API token (not required for normal use)
SIGNNOW_TOKEN=<access_token>

# OAuth server (if you enable OAuth mode)
OAUTH_ISSUER=<your_issuer_url>
ACCESS_TTL=3600
REFRESH_TTL=2592000
ALLOWED_REDIRECTS=<comma,separated,uris>

# RSA keys for OAuth (critical in production)
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"
    }
  }
}

その後、チャットを開いてエージェントモードにし、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 (テスト用)

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

# Start Inspector (opens UI on localhost)
npx @modelcontextprotocol/inspector

# Connect (STDIO): run your server locally and attach
sn-mcp serve

# Or connect (HTTP): use http://localhost:8000/mcp

ツールの一覧表示、JSON引数での呼び出し、レスポンスの検査が可能です。

ツール

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

  • list_all_templates — 簡略化されたメタデータを含むテンプレートとテンプレートグループを一覧表示します。limit/offsetページネーションをサポート（デフォルト：1ページあたり50項目）。

  • list_documents — ドキュメント、ドキュメントグループ、ステータスを閲覧します。limit/offsetページネーションをサポート（デフォルト：1ページあたり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 — 個々のドキュメントのテキストフィールドを事前入力。

  • upload_document — ローカルファイルパス (file_path)、パブリックURL (file_url)、またはMCPリソース添付ファイル (resource_uri) からドキュメントをアップロードします。file_path の場合、解決されたパスは設定された安全なベースディレクトリ（デフォルトではユーザーのホームディレクトリ）内にある必要があります。ベース外のパスは検証に失敗します。サポート形式：PDF, DOC, DOCX, PNG, JPG, JPEG。最大40MB。document_id, filename, source を返します。

  • send_invite_reminder — ドキュメントまたはドキュメントグループの保留中の署名者に署名リマインダーを送信します。

  • signnow_skills — バンドルされているSignNowスキルライブラリをクエリします。skill_name を省略すると、利用可能なすべてのスキルと説明が一覧表示されます。skill_name（例：signnow101）を指定すると、完全なMarkdown本文を取得します。signnow101 を使用して、SignNowのエンティティタイプ、招待タイプ、ツールマッピングを学習してください。

    • リストモードの例：{"skills": [{"name": "signnow101", "description": "SignNow 101 コンセプトのリファレンス... (説明は簡潔にするため省略)"}]}

    • フェッチモードの例：{"name": "signnow101", "body": "# SignNow 101 — コンセプトのリファレンス\n..."}

ヒント：まずは signnow_skills（引数なし）で利用可能なスキルを確認し、次に list_all_templates → create_from_template → create_embedded_* / send_invite、最後に get_invite_status と get_document_download_link を使用してください。

FAQ / ヒント

  • STDIO vs Docker? ローカル開発には STDIO を優先し、Docker内では HTTP を使用してください。

  • サンドボックス vs 本番環境? SignNowのサンドボックス/開発用認証情報から始めてください。本番環境には適切なOAuthと永続的なRSA秘密鍵が必要です。

  • 正確なツールスキーマはどこで見れますか? MCP Inspector またはクライアントの「ツール詳細」ビューを使用してください。

  • 例はどこにありますか? このリポジトリの examples/ を参照してください。

例

examples/ ディレクトリには、SignNow MCPサーバーを一般的なAIエージェントフレームワークと統合する方法の動作例が含まれています：

  • LangChain - langchain-mcp-adapters を使用したLangChainエージェントとの統合

  • LlamaIndex - llama-index-tools-mcp を使用したLlamaIndexエージェントとの統合

  • SmolAgents - ネイティブMCPサポートを使用したSmolAgentsフレームワークとの統合

各例では、以下の方法を実演しています：

  • MCPサーバーをサブプロセスとして起動する

  • MCPツールをフレームワーク固有のツール形式に変換する

  • SignNow機能を使用できるエージェントを作成する

  • 環境変数の設定を処理する

例を実行するには：

# Make sure you have the required dependencies installed
pip install langchain-openai langchain-mcp-adapters  # for LangChain example
pip install llama-index-tools-mcp                   # for LlamaIndex example  
pip install smolagents                              # for SmolAgents example

# Set up your .env file with SignNow credentials and LLM configuration
# Then run the example
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ヘルパーMCP

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

ライセンス

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

About SignNow MCP Server — SignNowチームによって保守されています。問題や貢献はGitHubのプルリクエストから歓迎します。

Install Server
A
security – no known vulnerabilities
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/signnow/sn-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server