Theneo
Theneo · コーディング
TheneoはAPI仕様書から、リファレンス、ガイド、変更履歴、AI検索を備えたブランド付きの開発者ポータルを作るAIプラットフォームだ。一度書けば、人間もAIエージェントも同じ内容を読める。
Theneo について
About
Theneoとは
Theneoは、APIドキュメントの手直しを人手に頼らずに済ませるためのプラットフォームだ。OpenAPI、GraphQL、SOAP、AsyncAPI、gRPCのいずれかの仕様書を読み込ませると、パラメータ、リクエスト例、テスト環境を揃えたページが組み上がる。ガイドと変更履歴も同じプロジェクトに入るので、呼び出し方を知るためにポータルの外へ出る必要はない。
同社は2022年からAIでドキュメントを生成してきたと説明し、1万8000社以上が利用しているとする。セキュリティ面ではSOC 2 Type II、ISO 27001、ISO 9001、GDPR対応、EU域内データ保管の選択肢を挙げている。企業の購買担当が確認する項目は一通りそろっている。
制約は規模と運用にある。無料プランは公開プロジェクト1件、エンドポイント2000件までで、大きなAPIは有料プランから始めることになる。生成された文章は人の目で一度通す必要があり、仕様書が粗ければ出力も粗くなる。
Getting Started
- app.theneo.ioでアカウントを作り、チーム用のワークスペースを開く。
- 仕様書を読み込むか、GitHub、Bitbucket、Postman経由でリポジトリをつなぐ。
- リファレンスを生成し、読みにくい説明を直してガイドや記事を足す。
- ブランド、独自ドメイン、アクセス権を設定して公開する。
AIツール情報
Theneoの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- APIプラットフォームの担当チーム：仕様書1本からリファレンスと変更履歴を用意できる。ただし仕様書を継続して管理する人が要る。
- エンジニアと組むテクニカルライター：メールでファイルを集める代わりに、同じページをその場で共同編集できる。
- パートナー向けAPIを持つB2B企業：顧客ごとにポータルを分け、契約したエンドポイントだけを見せる運用に向く。
タスク
- OpenAPIファイルを公開可能なリファレンスにする：読み込むと説明文の下書きが出るので、日本語として不自然な箇所を直す。
- 破壊的変更を示すリリースノートを書く：変更履歴が版を比較し、削除されたフィールドや変わったレスポンスを指し示す。
- 問い合わせを開かずに開発者の疑問へ答える：Ask AIがドキュメントを読み、根拠の節を添えて返す。
シーン
- v1 APIと同時にドキュメントを出す：仕様が固まるまでの間は無料プランで最初の公開プロジェクトを回せる。
- 監査記録を求める規制業種：多段階レビュー、独自ロール、完全なログは上位プランで使える。
- MCPサーバーを配るチーム：llms.txtとMCPエンドポイントを用意すれば、エージェントは人間と同じ文書を構造を保ったまま読む。
主な機能
仕様書からリファレンスを生成
ドキュメント生成ツールがAPIの説明を読み、パラメータ、リクエスト例、レスポンス表を備えたエンドポイントページを書く。ファイルを入れて数分で動くリファレンスが手に入る。白紙から始める必要はない。REST、GraphQL、SOAP、AsyncAPI、gRPCに対応し、古いSOAP連携と新しいRESTルートが同居する製品でも困らない。
Ask AIをドキュメント内に
読者はサイドバーをたどらず、質問を打ち込む。Ask AIがポータル内を検索し、日常的な言葉で答えを返し、根拠のページへリンクする。同社は他社のドキュメントAIより比較評価で上回ると主張するが、これは提供元の数字だ。出発点として扱い、証明とは考えないほうがよい。
破壊的変更を拾う変更履歴
API変更履歴は版ごとに直前の仕様と比べる。追加されたフィールド、消えたエンドポイント、変わったレスポンスが項目として並び、互換性を壊す変更には印が付く。リリースノート作りは確認作業に変わる。ただし、読者が欲しがる平易な要約は今も人が書く。
公開と非公開の開発者ポータル
B2Bプラットフォームでは、公開サイトを作るだけでは半分だ。Theneoは認証付きのポータルを用意でき、顧客は契約に含まれるAPI、ガイド、SDKだけを見る。入り口はメール招待、JWTログイン、SSOから選べ、ポータルごとにブランドを変えられる。
APIエクスプローラでその場で試す
ページ内でリクエストを送れる。事前スクリプトと保存済みトークンにも対応する。curlコマンドをコピーし、ターミナルに移り、認証エラーで止まる流れを省ける。OpenAPIやMarkdownへの書き出しもできるので、他社へ移る場合も作業が残らない。
MCPサーバーとllms.txt
Theneoで公開したドキュメントはMCPサーバーとして、またllms.txtとして外に出せる。AIコーディングアシスタントは人間と同じリファレンスを、構造を保ったまま読む。チャットにリンクを貼るのと、問い合わせ可能な情報源を渡すのとでは、結果が違ってくる。
メリットとデメリット
メリット
- 仕様書1本がリファレンス、テスト環境、コードサンプル、変更履歴を支え、各所がばらけない。
- 共同編集は、ライターとエンジニアが同じページを見るチームに向く。
- 独自ドメイン、CSS、ホワイトラベルでポータルが製品の一部に見える。
- 顧客別の非公開ポータルは、公開サイトでは扱えないパートナー案件をカバーする。
- 無料プランでも小さな公開APIは運用でき、支払う前に流れを試せる。
デメリット
- Businessはワークスペースあたり月120ドルからで、小さなチームには無料との差が大きい。
- 生成された説明は人の手直しが要り、薄い仕様書は薄いドキュメントになる。
- エンドポイント上限（無料2000、Business 5000）のため、APIが育つとプラン変更を迫られる。
- セルフホスティングとSAML SSOはEnterprise限定で、表示価格のプランでは選べない。
よくある質問
API仕様書からドキュメントを生成し、ガイド、変更履歴、テスト環境、AI検索を備えた開発者ポータルとして公開する。
関連コンテンツ
Theneoに関連するツール、スキル、記事を探す。
Theneoの代替ツール
Base Code
Base44 (Wix) · コーディング · 生産性向上Base CodeはBase44の共有クラウド開発環境だ。既存のGitHubリポジトリに対する変更をチャットで伝え、プレビューで確認し、プルリクエストとして返せる。
Google EmbeddingGemma 2
Google DeepMind · ライティング · 画像 · コーディングGoogle EmbeddingGemma 2 は 7 億 4000 万パラメータのオープンなモデルで、テキスト、コード、画像、音声、動画フレームを同じ 768 次元空間のベクトルに変え、スマートフォンやノート PC 上で動く。
GitGlow
GitGlow · コーディング · 生産性向上GitGlow は自分のコードと AI エージェントの変更を一つのレビューにまとめるデスクトップ Git クライアントだ。出荷前に、マシンから何が出ていくのかを確かめられる。