Ikiform

Ikiform for Claude Code and other agents

Ikiform はあらゆるフォームのバックエンドです。HTML フォーム、フレームワークのフォーム、またはサーバーリクエストから https://ikiform.com/f/<formId> に送信してください。Ikiform は送信内容を検証し、スパムをブロックして保存し、署名付き Webhook を送信します。

このリポジトリには次の 2 つが含まれています。

• エージェントスキル（ikiform）：フォームを Ikiform に接続する方法、サーバーから送信する方法、Ikiform Webhook を検証する方法、送信内容をトリアージする方法をコーディングエージェントに教えます。Claude Code および SKILL.md スキルを読み込めるあらゆるエージェントで動作します。
• Claude Code プラグイン：このスキルと Ikiform MCP サーバーをまとめたもので、エージェントがフォームの検索や作成、送信内容の読み取り、Webhook のデバッグを行えます。

Claude Code にインストールする

Claude Code のセッションで：

/plugin marketplace add preetsuthar17/ikiform-plugin
/plugin install ikiform@ikiform

またはシェルから：

claude plugin marketplace add preetsuthar17/ikiform-plugin
claude plugin install ikiform@ikiform

API キーを設定する

プラグインの MCP サーバーは、IKIFORM_API_KEY 環境変数からキーを読み取ります。

1. https://ikiform.com/dashboard/api-keys でシークレットキーを作成します。

2. エージェントに許可するスコープを設定します。

   スコープ	エージェントに許可する操作
   forms:read	フォームの一覧表示、フォームのエンドポイント、フィールド、設定手順の読み取り
   forms:write	フォームの作成、名前、許可ドメイン、リダイレクト URL の変更
   submissions:read	送信内容の一覧表示と読み取り
   submissions:write	送信内容をスパムまたは非スパムとしてマークし、削除
   webhooks:read	Webhook エンドポイントと配信の一覧表示
   webhooks:write	テストイベントの送信と失敗した配信の再実行

   forms:read があれば、フォームをコードに接続できます。エージェントに追加の操作をさせたい場合にのみ、ほかのスコープを追加してください。

3. Claude Code を起動するシェルでキーをエクスポートします。たとえば ~/.zshrc に設定します。

   export IKIFORM_API_KEY=ik_sk_...
   

4. Claude Code を起動して /mcp を実行します。サーバーは plugin:ikiform:ikiform として表示されます。

キーはシークレットです。シェルの設定ファイルまたはシークレットマネージャーに保管し、リポジトリやブラウザーのコードには決して含めないでください。

このスキルはキーがなくても動作します。キーがない場合、エージェントはフォームを検索する代わりに、ダッシュボードにあるフォーム ID を尋ねます。

使い方

次のように、普通の言葉で依頼してください。

• 「このプロジェクトの問い合わせフォームを Ikiform に接続してください。」
• 「ランディングページにウェイトリストフォームを追加し、Ikiform に送信してください。」
• 「Express サーバーで Ikiform Webhook を検証してください。」
• 「Contact フォームで今週発生したスパムを見せてください。」
• 「Ikiform Webhook が失敗する原因を教えてください。」

または、/ikiform:ikiform でスキルを直接実行します。

エージェントは、送信内容の削除や Webhook 配信の再実行を行う前に確認を求めます。

ほかのエージェントでスキルを使う

このスキルは通常の Agent Skills フォルダーです。plugins/ikiform/skills/ikiform/ にあります。エージェントのスキルディレクトリにコピーしてください。

Claude Code、Cursor、Codex などのエージェントでは、skills CLI を使います。

npx skills add preetsuthar17/ikiform-plugin

プラグインを使わずに Claude Code を使用する場合：

git clone https://github.com/preetsuthar17/ikiform-plugin ikiform-plugin
mkdir -p ~/.claude/skills
cp -R ikiform-plugin/plugins/ikiform/skills/ikiform ~/.claude/skills/ikiform

プロジェクト内の .claude/skills/ikiform を使うと、チームで共有できます。ほかのエージェントの場合は、同じフォルダーを、そのエージェントがスキルを読み込むディレクトリにコピーしてください。このスキルのフロントマターで使うのは name、description、license のみなので、移植性があります。

プラグインを使わずに MCP サーバーを接続する

サーバー：https://ikiform.com/mcp、Streamable HTTP、Authorization: Bearer ik_sk_... で認証します。

Claude Code

claude mcp add --transport http ikiform https://ikiform.com/mcp --header "Authorization: Bearer ik_sk_..."

Cursor

~/.cursor/mcp.json またはプロジェクト内の .cursor/mcp.json に設定します。

{
  "mcpServers": {
    "ikiform": {
      "url": "https://ikiform.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IKIFORM_API_KEY}"
      }
    }
  }
}

VS Code

.vscode/mcp.json に設定します。VS Code は初回にキーの入力を求め、キーを安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ikiform-api-key",
      "description": "Ikiform secret API key (ik_sk_...)",
      "password": true
    }
  ],
  "servers": {
    "ikiform": {
      "type": "http",
      "url": "https://ikiform.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ikiform-api-key}"
      }
    }
  }
}

ツール

ツールの全一覧と各ツールに必要なスコープについては、https://ikiform.com/docs/mcp#tools を参照してください。

サーバーには、フォームの設定手順を返す connect_form プロンプトもあります。

ディレクトリ構成

.claude-plugin/marketplace.json        the "ikiform" marketplace
plugins/ikiform/
  .claude-plugin/plugin.json           plugin manifest
  .claude-plugin/icon.png              listing icon
  .mcp.json                            the Ikiform MCP server
  skills/ikiform/SKILL.md              the skill
  skills/ikiform/references/*.md       detail the skill loads when needed
server.json                            MCP Registry listing
glama.json                             Glama listing
.github/workflows/publish-mcp.yml      publishes server.json to the MCP Registry
scripts/check.mjs                      offline checks

変更を確認する

Claude Code をインストール済みの場合：

claude plugin validate --strict .
claude plugin validate --strict ./plugins/ikiform

未インストールの場合、または CI では、オフラインチェックを実行します。Node 20 以降が必要で、パッケージは不要です：

node scripts/check.mjs

すべての JSON ファイルが解析できること、SKILL.md の name と description が Agent Skills の制限に準拠していること、相対リンクが解決できること、マーケットプレイスのエントリがプラグインマニフェストと一致していることを確認します。

公開前にローカルコピーを試すには：

claude plugin marketplace add ./
claude plugin install ikiform@ikiform

ドキュメント

• Ikiform のドキュメント：https://ikiform.com/docs
• エージェント向けの Markdown 版全文：https://ikiform.com/llms.txt
• サポート：[email protected]

ライセンス

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