ノーマンファイナンスMCPサーバー

このモデル コンテキスト プロトコル (MCP)サーバーにより、AI は Norman Finance API と対話できるようになり、標準化されたプロトコルを通じて会計、請求書、企業、顧客、税金などにアクセスできるようになります。

[！注記]

Norman Finance MCPサーバーは現在ベータ版です。皆様からのフィードバックをお待ちしております。また、バグを発見された場合は、こちらで問題を報告してください。

特徴

• 🔐認証：Norman Financeアカウントで安全に認証する

• 💼会社管理：会社の詳細を管理し、会社の残高、VATの収入などを取得します

• 📊会計：取引や分類に注意する

• 📝 （電子）請求書発行：請求書の作成、閲覧、送信、処理。契約内容に基づいて定期的な請求書発行を設定することもできます。

• 👥クライアント管理：クライアントの作成と管理（CRM）

• 💰税金：税金情報とレポートを表示し、Finanzamtの公式PDFプレビューを生成して税金を申告します

• 📄ドキュメント：添付ファイル（領収書、請求書、ドキュメントなど）をアップロードして管理します

👇 Claude Desktop のユースケース例 — 切り替え

Related MCP server: Nornir MCP Server

前提条件

この MCP サーバーを使用する前に、次のことを行う必要があります。

1. Norman Financeでアカウントを作成する

2. 認証のためにメールアドレスとパスワードを用意してください

リモートMCPサーバー

Norman は現在、次の場所でホスト型リモート MCP サーバーを提供しています。

https://mcp.norman.finance/sse

リモート MCP は OAuth 認証を利用し、アクセス トークンを手動で作成または管理する必要がなく、Norman アカウントで直接ログインできるため、推奨されます。

インストール

Claude.ai 統合

Claude.ai に Norman MCP サーバーを追加する:

クロード・マックスの場合:

1. 設定 > プロフィールへ

2. 「統合」セクションを見つけます

3. 「さらに追加」をタップします

4. Norman MCP サーバーの URL を入力します: https://mcp.norman.finance/sse

5. 「追加」をクリックして完了します

Claude Enterprise & Teamsの場合:

1. [設定] > [統合] (Teams の場合) または*[設定] > [データ管理]* (Enterprise の場合) に移動します。

2. 「統合」セクションを見つけます

3. 「さらに追加」をクリック

4. Norman MCP サーバーの URL を入力します: https://mcp.norman.finance/sse

5. 「追加」をクリックして完了します

Norman 統合を有効にする:

1. クロードとチャットを始めましょう。

2. 検索とツールメニューを開きます。

3. 「接続」をクリックして、Norman アカウントをリンクします。

4. 接続後、同じメニューを使用して特定の Norman ツールをオンにします。

Claudeデスクトップに追加

Claude Desktop で Norman Finance MCP サーバーを実行するには、上記の手順を使用するか、次の手順で手動で追加します。

1. Claude Desktopをダウンロードして設定する

1. Claude Desktopをダウンロードしてください。

2. Claude を起動し、「設定」>「開発者」>「構成の編集」に移動します。

3. 次の構成でclaude_desktop_config.jsonファイルを更新します。

リモートMCP

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.norman.finance/sse"]
    }
  }
}

ローカルMCP

uvをインストールする

こちらの手順に従ってください: uvのインストール

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<home_path>/.local/bin/uvx",
      "args": [
        "--from",
        "norman-mcp-server@latest",
        "norman-mcp"
      ],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

構成

認証方法

Norman MCP サーバーは、次の 2 つの認証方法をサポートしています。

1. OAuth認証（SSEトランスポート用）

MCP Inspector、Claude、またはその他の SSE クライアントでサーバーを使用する場合、サーバーは OAuth 2.0 認証を使用します。

1. SSE トランスポートを使用してサーバーを起動します。

   python -m norman_mcp --transport sse

2. サーバーに接続すると、ログインページが表示されます。

3. Norman Financeの資格情報を入力してください

4. 認証トークンを使用してアプリケーションにリダイレクトされます

2. 環境変数（stdioトランスポート用）

Claude Desktop または stdin/stdout 通信でサーバーを使用する場合は、環境変数を通じて資格情報を提供します。

# .env
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment
NORMAN_API_TIMEOUT=200  # Request timeout in seconds

環境変数

サーバーは、次の環境変数を使用して構成できます。

# Authentication (for stdio transport)
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment

# Server configuration
NORMAN_MCP_HOST=0.0.0.0  # Host to bind to
NORMAN_MCP_PORT=3001     # Port to bind to
NORMAN_MCP_PUBLIC_URL=http://example.com  # Public URL for OAuth callbacks (important for remote access)
NORMAN_API_TIMEOUT=200   # Request timeout in seconds

発達

このセクションは、Norman Finance MCP サーバーを開発または拡張したい貢献者向けです。

ローカルセットアップ

git clone https://github.com/norman-finance/norman-mcp-server.git
cd norman-mcp-server
pip install -e .

次に、claude_desktop_config.json ファイルを更新して、Python モジュールを直接ポイントするようにします。

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<path_to_your_python>/python",
      "args": ["-m", "norman_mcp"],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

機能に関するアイデアや、実現してほしい機能などがあれば、ぜひご提案ください。