feat: Add AI-scraping optimization and metadata to docs

docs/AI/mcp-service-creation.md

@@ -2,10 +2,24 @@
 sidebar_position: 2
 title: Creating an MCP Server Service
 id: mcp-service-creation
+description: Step-by-step guide to creating an MCP (Model Context Protocol) server service in DreamFactory for AI assistant integration
+keywords: [MCP, Model Context Protocol, AI integration, ChatGPT, Claude, Cursor, database API, AI assistant]
 ---
 
 # Creating an MCP Server Service
 
+## Quick Reference
+
+| Property | Value |
+|----------|-------|
+| **Service Type** | MCP Server |
+| **Required Fields** | API Name, Database Service |
+| **Auto-Generated** | OAuth Client ID, OAuth Client Secret |
+| **Authentication** | OAuth 2.0 |
+| **Supported AI Clients** | ChatGPT, Claude, Cursor, any MCP-compatible client |
+
+## Overview
+
 The Model Context Protocol (MCP) is a standardized protocol that enables AI assistants and development tools to interact with your DreamFactory database services through a consistent interface. Despite the growing popularity of direct API integrations, MCP-based connections remain an essential part of modern development workflows, allowing AI assistants like ChatGPT, Claude, and Cursor to seamlessly query and manipulate your database resources.
 
 But incorporating MCP functionality into your development environment can be challenging. Fortunately, you can use DreamFactory to easily create a full-featured MCP server that exposes your database services through the Model Context Protocol. This server can perform all of the standard database operations, including:
@@ -20,7 +34,7 @@ In this tutorial we'll show you how to configure DreamFactory's MCP server servi
 
 ## Generating the MCP Server and Companion Documentation
 
-To generate an SFTP REST API, log in to your DreamFactory instance using an administrator account, select AI tab, and then click the purple plus button to establish a new connection:
+To create an MCP Server service, log in to your DreamFactory instance using an administrator account, select the **AI** tab, and then click the purple plus button to create a new connection:
 
 ![ai api creation](/img/api-generation-and-connections/api-types/utility/creating-mcp-server/ai-api-creation.png)
 

docs/AI/mcp-service.md

@@ -2,6 +2,9 @@
 sidebar_position: 1
 title: MCP Server
 id: mcp-server
+description: Integrate DreamFactory with AI assistants and dev tools using the Model Context Protocol (MCP) for database operations.
+keywords: [MCP, Model Context Protocol, AI integration, Claude, ChatGPT, database tools, streaming API, JSON-RPC]
+difficulty: advanced
 ---
 
 # MCP Server

docs/Security/authentication-apis.md

@@ -3,6 +3,9 @@ sidebar_position: 5
 title: Authenticating your APIs
 id: authenticating-your-apis
 draft: false
+description: Configure API authentication with Active Directory, LDAP, OAuth, SAML 2.0, OpenID Connect, Okta, and Auth0 SSO providers.
+keywords: [API authentication, OAuth, SAML, LDAP, Active Directory, SSO, OpenID Connect, Okta, Auth0, JWT]
+difficulty: intermediate
 ---
 
 One of DreamFactory's most popular features is the wide-ranging authentication support. While API Key-based authentication will suffice for many DreamFactory-powered applications, developers often require a higher degree of security through user-specific authentication. In some cases Basic HTTP authentication will get the job done, however many enterprises require more sophisticated and flexible approaches largely because of the growing adoption of Single Sign On (SSO)-based solutions such as Active Directory and LDAP, and use of third-party identity providers and solutions such as [AWS Cognito](https://aws.amazon.com/cognito/), [Auth0](https://auth0.com/), and [Okta](https://www.okta.com/).

docs/Security/role-based-access.md

@@ -1,10 +1,29 @@
 ---
 sidebar_position: 1
-title: Role Based Access
+title: Role Based Access Control (RBAC)
 id: role-based-access
+description: Configure granular permissions for API access using DreamFactory's role-based access control system
+keywords: [RBAC, role-based access, API security, permissions, access control, API keys]
+difficulty: "beginner"
 ---
 
-# Role Based Access
+# Role Based Access Control (RBAC)
+
+## Quick Reference
+
+| Concept | Description |
+|---------|-------------|
+| **Role** | A named set of permissions that define which services and operations are allowed |
+| **Service** | An API endpoint (database, file storage, etc.) |
+| **Component** | A specific resource within a service (e.g., `_table/employees`) |
+| **Access** | HTTP methods allowed (GET, POST, PUT, PATCH, DELETE) |
+| **API Key** | Authentication token associated with one or more roles |
+
+## Permission Hierarchy
+
+```
+API Key → Role(s) → Service Access → Component Access → HTTP Methods
+```
 
 ## Creating Role Based Access Controls
 

docs/Security/security-faq.md

@@ -1,6 +1,9 @@
 ---
 title: Security FAQ
 id: security-faq
+description: "Answers to common security questions about DreamFactory's platform, compliance, encryption, and best practices"
+keywords: [security, compliance, HIPAA, GDPR, encryption, data protection, password recovery, hardening]
+difficulty: "beginner"
 ---
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';